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使 用 Spring Cloud4 Docker 3: E 4 IR. 2 


本 文 是 对 Spring Cloud 和 Docker 的 实战 与 总 结 ， 目 前 在 Git@0SC 以 及 Github 
上 同步 更 新 。 

阅读 地 址 : 虽然 可 直接 在 Git@OSC/GitHub 上 直接 阅读 。 但 是 建议 使 用 GitBook ， 
阅读 体验 更 好 。 


e 前 往 以 下 地 址 阅读 : http://book.itmuch.com 

e 直接 访问 Gitbook 官 网 : https://eacdy.gitbooks.io/spring-cloud-book/content/ 

e. 将 代码 clone 到 本 地 后 ， 使 用 Typora 或 Atom 等 Markdown 阅 读 软 件 进行 阅读 ， 也 
可 使 用 Gitbook 进 行 构建 。 
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Spring Cloud 核 心 组 件 的 系统 讲解 


e 帮助 大 家 快速 上 手 ， 理 解 Spring Cloud 各 组 件 的 用 途 
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1 微服 务 简 介 


什么 是 微服 务 架 构 


近年 来 ， 在 软件 开发 领域 关于 微服 务 的 讨论 呈现 出 火爆 的 局 面 ， 有 人 倾向 于 在 系统 
设计 与 开发 中 采用 微服 务 方式 实现 软件 系统 的 松 耦 合 、 跨 部 门 开发 ， 被 认为 是 IT 软 
件 架 构 的 未 来 方向 ，Martin Fowler 也 给 微服 务 架 构 极 高 的 评价 ; 同时 ， 反 对 之 声 也 
很 强烈 ， 持 反对 观点 的 人 表示 微服 务 增加 了 系统 维护 、 部 署 的 难度 ， 导 致 一 些 功 能 
模块 或 代码 无 法 复 用 ， 同 时 微服 务 允许 使 用 不 同 的 语言 和 框架 来 开发 各 个 系统 模 

块 ， 这 又 会 增加 系统 集成 与 测试 的 难度 ， 而 且 随 着 系统 规模 的 日 渐 增 长 ， 微 服务 在 
一 定 程度 上 也 会 导致 系统 变 得 越 来 越 复杂 。 尽 管 一 些 公司 已 经 在 生产 系统 中 采用 了 
微服 务 架构 ， 并 且 取 得 了 良好 的 效果 ; 但 更 多 公司 还 是 处 在 观望 的 态度 。 

什么 是 微服 务 架 构 呢 ? 简单 说 就 是 将 一 个 完整 的 应 用 ( 单 体 应 用 ) 按照 一 定 的 拆 分 
规则 (后 文 讲 述 ) 拆 分 成 多 个 不 同 的 服务 ， 每 个 服务 都 能 独立 地 进行 开发 、 部 署 、 
扩展 。 服 务 于 服务 之 间 通 过 注入 RESTful api 或 其 他 方式 调用 。 大 家 可 以 搜索 到 很 多 
相关 介绍 和 文章 。 本 文 暂 不 细 表 。 在 此 推荐 两 个 比较 好 的 博客 : 


http://microservices.io/ http://martinfowler.com/articles/microservices.html 


2 Spring Cloud 


Spring Cloud 简介 
Spring Cloud # Spring Boot 的 基础 上 构建 的 ， 用 于 简化 分 布 式 系统 构建 的 工具 
集 ， 为 开发 人 员 提 供 快速 建立 分 布 式 系统 中 的 一 些 常见 的 模式 。 


例如 : 配置 管理 (configuration management) ， 服 务 发 现 (service 
discovery) >° WH% (circuit breakers) > #7 4438 ( intelligent routing) ， 
fix X FZ (micro-proxy) ， 控 制 总 线 (control bus) > — XE 4€ ( one-time 
tokens) ， 全 局 锁 (globallocks) > 41-42 (leadership election) > JA X 


4 i& (distributed sessions) ， 集 群 状态 (cluster state) > 
Spring Cloud & € f $ ^- TB: 

例如 : Spring Cloud Config ` Spring Cloud Netflix 
Spring Cloud 项 目 主页 : http://projects.spring.io/spring-cloud/ 


Talk is cheap, show me the code. 下 面 我 们 将 以 代码 与 讲解 结合 的 方式 ， 为 大 家 讲 
ff Spring Cloud 中 的 各 种 组 件 。 


准备 工作 


e 技术 储备 : 
所 需 技能 备注 
Java 
Maven 文章 涉及 到 大 量 的 代码 ， 均 使 用 Maven 构 建 
Spring Boot Spring Cloud Æ Æ Spring Boot 基 础 上 构建 的 


e 环境 准备 : 


工具 版 本 或 描述 


JDK 1.8 
IDE STS 或 者 IntelliJ IDEA ， 本 教程 使 用 的 是 STS. 
Maven 3.x 


o 本 课程 所 使 用 的 软件 及 版 本 : 


使 用 到 的 软件 版 本 号 是 否 最 新 版 本 
Spring Boot 1.4.0.RELEASE 是 
Spring Cloud Brixton.SR5 是 


e Host 配 置 : 在 生产 环境 下 ， 我 们 往往 会 为 每 个 应 用 配置 一 个 host， 使 用 host 而 
非 I|P 进 行 访问 。 为 了 更 加 贴近 生产 环境 ， 以 及 后 文 Docker 章 节 的 讲解 ， 我 们 配 
置 一 下 Host。 在 Windows 系 统 下 ， 


是 C:\Windows\System32\drivers\etc\hosts 文件 ， 在 Linux 系 统 下 ， 
是 /etc/hosts 文件 : 


Host à 


127.0.0.1 discovery config-server gateway movie user feign ribbon 


e 主机 规划 


项 目 名 称 端口 描述 URL 
microservice-api-gateway 8050 API Gateway 详 见 文章 
务 $ 客 2 ~ 

microservice-config-client 8041 5 in 0 详 见 文章 
microservice-config-server 8040 ”配置 服务 详 见 文章 
microservice-consumer-movie- 8020 | Feign Demo EE 
feign 
microservice-consumer-movie- 8021 Feign Hystrix /feign/1 
feign-with-hystrix Demo 
microservice-consumer-movie- ee 
feign-with-hystrix-stream SUA | DEESEUT dead 

Demo 
ME awa KA 8010 Ribbon Demo /ribbon/1 
ribbon 
microservice-consumer-movie- 8011 Ribbon Hystrix IPSO 
ribbon-with-hystrix Demo 
microservice-discovery-eureka 8761 ”注册 中 心 / 
microservice-hystrix-dashboard 8030 ”hystrix 监控 /hystrix.stream 
microservice-hystrix-turbine 8031 turbine /turbine.stream 
microservice-provider-user 8000 服务 提供 者 /1 


e Spring Cloud 所 有 的 配置 项 : 


http://cloud.spring.io/spring-cloud- 
static/Brixton.SR5/#_appendix_compendium_of_configuration_properties 


父 项 目的 建立 


在 进入 主题 之 前 ， 我 们 首先 创建 一 个 父 项 目 (spring-cloud-microservice-study) ， 
这 样 可 以 对 项 目 中 的 Maven 依 赖 进行 统一 的 管理 。 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns-"http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 


aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<groupiId>com. itmuch.cloud</groupId> 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>pom</packaging> 


<modules> 
<module>microservice-discovery -eureka</module> 
<module>microservice-provider -user</module> 
<module>microservice-consumer -movie-ribbon</module> 
<module>microservice-consumer -movie-feign</module> 
<module>microservice-consumer -movie-ribbon-with-hystrix</mod 
ule> 
<module>microservice-consumer -movie-feign-with-hystrix</modu 
le> 
<module>microservice-hystrix-dashboard</module> 
<module>microservice-consumer -movie-feign-with-hystrix-stream 
</module> 
<module>microservice-hystrix-turbine</module> 
<module>microservice-config-server</module> 
<module>microservice -config-client</module> 
<module>microservice-config-server -eureka</module> 
<module>microservice-config-client -eureka</module> 
<module>microservice-api-gateway</module> 
</modules> 


<parent> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-parent</artifactid> 
<version>1.4.0.RELEASE</version> 

</parent> 


<properties> 
<project.build.sourceEncoding>UTF-8</project.build.sourceEnc 
oding> 
<java.version>1.8</java.version> 
</properties> 


<dependencyManagement> 
<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-dependencies</artifactId> 
<version>Brixton.SR5</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


<build> 
<plugins> 
<plugin> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-maven-plugin</artifactId> 
</plugin> 
</plugins> 
</build> 
</project> 


[| 


TIPS 


1. 笔者 讲解 采用 最 新 的 Spring Boot 和 Spring Cloud 进 行 讲解 ， 其 中 可 能 涉及 到 部 
分 新 特性 ， 笔 者 尽量 指出 ， 同 时 笔者 能 力 有 限 ， 如 有 理解 不 到 位 的 地 方 ， 还 请 
各 位 看 客 指出 ， 定 在 第 一 时 间 进 行 修正 。 

2. Spring Cloud 版 本 并 不 是 传统 的 使 用 数字 的 方式 标识 ， 而 是 使 用 例如 : Angel ^ 
Brixton、Camden... 等 等 伦敦 的 地 名 来 命名 版 本 ， 版 本 的 先后 顺序 大 家 可 能 
经 猜 到 了 ， 就 是 使 用 字母 表 的 先后 来 标识 的 。 笔 者 在 咨询 过 Spring Cloud 的 主 
要 贡献 者 之 一 Josh Long 之 后 已 经 确认 。 


2.1 服务 发 现 


关于 服务 发 现 


在 微服 务 架 构 中 ， 服 务 发 现 (Service Discovery) 是 关键 原则 之 一 。 手 动 配置 每 个 
客户 端 或 某 种 形式 的 约定 是 很 难 做 的 ， 并 且 很 脆弱 。Spring Cloud 提 供 了 多 种 服务 
发 现 的 实现 方式 ， 例 如 : Eureka、Consul、Zookeeper。 


Spring Cloud 支 持 得 最 好 的 是 Eureka， 其 次 是 Consul， 最 次 是 Zookeeper。 


2.1.1 Eureka 


准备 工作 
e 在 生产 环境 下 ， 我 们 往往 会 为 每 个 应 用 配置 一 个 host， 使 用 host 而 非 IP 进 行 访 
问 。 为 了 更 加 贴近 生产 环境 ， 以 及 后 文 Docker 章 节 的 讲解 ， 我 们 首先 配置 一 下 
Host 


127.0.0.1 discovery 


代码 示例 


e 创建 一 个 Maven 工 程 (microservice-discovery-eureka) ， 并 在 pom.xml 中 加 入 
如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-discovery-eureka</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId» 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
«artifactId»spring-cloud-starter-eureka-server«/artifactId» 


«/dependency» 
«/dependencies» 
</project> 


:| 


e 编写 Spring Boots 442% : 3$ xt (gEnableEurekaServer t W] — 4- ix AE P «5 : 


/** 
* 使 用 Eureka 做 服务 发 现 。 
* @author eacdy 
WA 
@SpringBootApplication 
@EnableEurekaServer 
public class EurekaApplication { 
public static void main(String[] args) { 
SpringApplication.run(EurekaApplication.class, args); 


e 在 默认 情况 下 ，Eureka 会 将 自己 也 作为 客户 端 尝试 注册 ， 所 以 在 单机 模式 下 ， 
我 们 需要 禁止 该 行为 ， 只 需要 在 application.yml 中 如 下 配置 : 


server: 
port: 8761 # 指定 该 Eureka 实 例 的 端口 


eureka: 
instance: 
hostname: discovery # 指定 该 Eureka 实 例 的 主机 名 
client: 
registerWithEureka: false 
fetchRegistry: false 
serviceUrl: 
defaultZone: http://${eureka.instance.hostname}:${server.p 
ort}/eureka/ 


# 参考 文档 :http://projects.spring.io/spring-cloud/docs/1.0.3/spri 
ng-cloud.html#_standalone_mode 
# 参考 文档 :http://my.oschina.net/buwei/blog/618756 


e 局 动工 程 后 ， 访 问 : http://discovery:8761/ ， 如 下 图 。 我 们 会 发 现 此 时 还 没有 
服务 注册 到 Eureka 上 面 。 


DS Replicas 
localhost 


Instances currently registered with Eureka 


Application AMIs Availability Zones 


No instances available 


代码 地 址 ( 任 选 其 一 ) 


http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice- 
discovery-eureka https://github.com/eacdy/spring-cloud- 
study/tree/master/microservice-discovery-eureka 


2.1.2 Eureka 的 高 可 用 


按照 前 文 对 Eureka 的 讲解 ， 我 们 即 可 构建 出 一 个 简单 的 注册 中 心 。 但 此 时 的 Eureka 
是 单 点 的 ， 不 适合 于 生产 环境 ， 那 么 如 何 实现 Eureka 的 高 可 用 呢 ? 


e 添加 主机 名 : 


127.0.0.1 peer1 peer2 


e 修改 application.yml 


Spring: 

profiles: peer1 # 指定 profile=p 
eer 
server: 

port: 8761 
eureka: 

instance: 

hostname: peeri 4 指定 当 profile 

=peer1 时 ， 主 机 名 

client: 
serviceUrl: 

defaultZone: http://peer2:8762/eureka/ # 将 自己 注册 到 pe 


er23aX ^-Eureka.E d zx 


spring: 
profiles: peer2 
server: 
port: 8762 
eureka: 
instance: 
hostname: peer2 
client: 
serviceUrl: 
defaultZone: http://peer1:8761/eureka/ 


e 分 别 局 动 两 个 Eureka 应 用 : 


java -jar microservice-discovery-eureka-0.0.1-SNAPSHOT.jar --spr 
ing.profiles.active-peer1 
java -jar microservice-discovery-eureka-0.0.1-SNAPSHOT.jar --spr 
ing.profiles.active-peer2 


e 访问 http://peeri:8761 ， 我 们 会 发 现 registered-replicas 中 已 经 
有 peer2 节点 了 ， 同 样 地 ， 访 问 http://peer2:8762 ， 也 能 发 现 其 中 
的 registered-replicas 有 peeri 节点 ， 如 下 图 : 


DS Replicas 





Instances currently registered with Eureka 


Application AMIs Availability Zones Status 


UNKNOWN n/a (2) (2) UP (2) - QH-20160301NAVT:8761 , QH-20160301NAVT:8762 


General Info 























Name Value 

total-avail-memory 450mb 

environment test 

num-of-cpus 4 

current-memory-usage 124mb (27%) 
server-uptime 00:01 
http://peer2:8762/eureka/ 
http://peer2:8762/eureka/, 


Instance Info 





Name Value 
ipAddr 192.168.0.59 
status UP 


e 我 们 尝试 将 peer2 节点 关闭 ， 然 后 访问 http://peeri:8761 ， 会 发 现 此 
时 peer2 会 被 添加 到 unavaliable-replicas 一 栏 中 。 


该 示例 中 的 hostname 并 非 必 须 的 ， 如 果 不 配置 ， 上 默认 将 会 使 用 |P 进 行 查 
找 。 


将 服务 注册 到 高 可 用 的 Eureka 


如 果 注 册 中 心 是 高 可 用 的 ， 那 么 各 个 微服 务 配置 只 需要 将 defaultzone AA k F 
Pp: 


eureka: 
client: 
serviceUrl: 
defaultZone: http://peer1:8761/eureka/,http://peer2:8762/e 
ureka 


参考 文档 


http://cloud.spring.io/spring-cloud-static/Brixton.SR5/#spring-cloud-eureka- 
server 


2.1.3 Consul 


Consul  HashiCorp 公司 推出 的 开源 工具 ， 用 于 实现 分 布 式 系统 的 服务 发 现 与 配 
置 。 与 其 他 分 布 式 服务 注册 与 发 现 的 方案 ，Consul 的 方案 更 “一 站 式 "， 内 置 了 服务 
注册 与 发 现 框 架 、 分 布 一 致 性 协议 实现 、 健 康 检 查 、Key/Value 存 储 、 多 数据 中 心 
方案 ， 不 再 需要 依赖 其 他 工具 (比如 ZooKeeper 等 ) 。 使 用 起 来 也 较 为 简单 。 
Consul 使 用 Go 语言 编写 ， 因 此 具有 天 然 可 移植 性 (支持 Linux、windows 和 Mac OS 
X) ; 安装 包 仅 包含 一 个 可 执行 文件 ， 方 便 部 署 ， 与 Docker 等 轻 量 级 容器 可 无 颖 配合 


o 


下 面 以 Consu| CentOS 7 系统 下 为 例 ， 讲 解 Consul 的 安装 及 使 用 ， 其 他 平台 的 安 
装 也 是 类 似 的 ， 所 使 用 的 Consul 7) v0.7.0 ° 


Consul 下 载 页 面 : https://www.consul.io/downloads.html ° 


2.1.4 Consul X 5 4$ M 


准备 工作 
一 台 CentOS 7 机 器 ， 输 入 ifconfig ， 查 看 网 卡 信息 如 下 : 


eno16777736: flags=4163<UP, BROADCAST, RUNNING,MULTICAST> mtu 150 
0 

inet 192.168.11.143 netmask 255.255.255.0 broadcast 19 
2.168.11.255 

inet6 fe80::20c:29ff:fe89:6b91 prefixlen 64 scopeid 0x 
20«link» 

ether 00:0c:29:89:6b:91 txqueuelen 1000 (Ethernet) 

RX packets 752526 bytes 705406371 (672.7 MiB) 

RX errors 0 dropped O overruns O frame 0 

TX packets 142062 bytes 18646825 (17.7 MiB) 

TX errors © dropped © overruns © carrier © collisions 


lo: flags-73«UP,LOOPBACK,RUNNING» mtu 65536 
inet 127.0.0.1 netmask 255.0.0.0 
inet6 ::1 prefixlen 128 scopeid 0x10<host> 
loop txqueuelen 0 (Local Loopback) 
RX packets 172 bytes 1003766 (980.2 KiB) 
RX errors 0 dropped O overruns O frame 0 
TX packets 172 bytes 1003766 (980.2 KiB) 
TX errors © dropped © overruns © carrier © collisions 


我 们 可 以 看 到 ， 该 机 器 有 两 个 IP : 


192.168.11.143 
127.0.0.1 


Consul 的 安装 与 启动 


e 4X € Consul (以 CentOS7 为 例 ) 


cd /usr/local/bin/ 


wget https://releases.hashicorp.com/consul/0.7.0/consul 0.7.0 li 
nux amd64.zip 


unzip consul0.7.01inux amd64.zip 


得 到 consul 文件 ， 这 样 就 完成 了 安装 。 


e È Consul 


./consul agent -dev # -dev 表 示 开 发 模式 运行 ， 另 外 还 有 -serve 
r 表 示 服 务 模式 运行 


e 输入 http://127.0.0.1:8500/ui/ 访问 Consul， 可 查看 到 如 下 界面 : 


Consulby HashiCorp KIF 


127.0.0.1 c 
C SERVICES NODES KEY/VALUE ACL 


J consul 
v EXPAND 


any status 


consul 1 passing TAGS 





No tags 


NODE 
fi localhost.localdomain 
i Serf Health Status serfHealt! 
4. 我 们 尝试 访问 http://192.168.11.143/ui/ ， 会 发 现 无 法 访问 。 说 明 Consul 
还 不 能 被 远程 访问 。 那 么 如 何 设置 才能 被 远程 访问 呢 ? Consul 如 何 高 可 用 呢 ? 


2.1.5 Consul ¥ M 4» 4 


Consul € MaA 


命令 解释 示例 
agent 运行 一 个 consul agent consul agent -dev 
join 将 agent 加 入 到 consul 集 群 consul join IP 
members 列 出 consul cluster 集 群 中 的 members consul members 
leave 将 节点 移 除 所 在 集群 consul leave 


consul agent 命令 详解 
输入 consul agent --help ， 可 以 看 到 consul agent 的 选项 ， 如 下 : 
-advertise=addr Sets the advertise address to use 


-advertise-wan=addr Sets address to advertise on wan inst 
ead of advertise addr 


-atlas=org/name Sets the Atlas infrastructure name, e 
nables SCADA. 

-atlas-join Enables auto-joining the Atlas cluste 
a 

-atlas-token-token Provides the Atlas API token 

-atlas-endpoint-1.2.3.4 The address of the endpoint for Atlas 
integration. 

-bootstrap Sets server to bootstrap mode 

-bind-0.0.0.0 Sets the bind address for cluster com 
munication 

-http-port-8500 Sets the HTTP API port to listen on 

-bootstrap-expect=0 Sets server to expect bootstrap mode. 

-client-127.0.0.1 Sets the address to bind for client a 
ccess. 


This includes RPC, DNS, HTTP and HTTP 
S (if configured) 


-config-file=foo 
tion from. 


-config-dir=foo 
tion files 


uerbis SONK 
alphabetical 
times. 
-data-dir-path 
nt state 
-dev 


-recursor=1.2.3.4 


-dc=east-aws 


use 'datacenter' instead). 


-datacenter=east -aws 
-encrypt=key 
-join=1.2.3.4 

time. 


-join-wan=1.2.3.4 
tart time. 


-retry-join=1.2.3.4 
time with 


tiple times. 
-retry-interval=30s 
-retry-max=0 

ults to 0, which 


-retry-join-wan=1.2.3.4 
tart time with 


tiple times. 
-retry-interval-wan=30s 
ts. 


Path to a JSON file to read configura 


This can be specified multiple times. 
Path to a directory to read configura 


from. This will read every file endin 
as configuration in this directory in 
order. This can be specified multiple 
Path to a data directory to store age 
Starts the agent in development mode. 
Address of an upstream DNS server. 
Can be specified multiple times. 
Datacenter of the agent (deprecated: 
Datacenter of the agent. 

Provides the gossip encryption key 


Address of an agent to join at start 


Can be specified multiple times. 
Address of an agent to join -wan at s 


Can be specified multiple times. 
Address of an agent to join at start 


retries enabled. Can be specified mul 


Time to wait between join attempts. 
Maximum number of join attempts. Defa 


will retry indefinitely. 
Address of an agent to join -wan at s 


retries enabled. Can be specified mul 


Time to wait between join -wan attemp 


-retry-max-wan=0 
Defaults to 0, which 


-log-level=info 
-node=hostname 
the cluster 
-protocol=N 
o latest. 
-rejoin 


to rejoin the cluster. 


-server 
-syslog 
-ui 

rver 
-ui-dir-path 

UI resources 
-pid-file-path 


consul agent 命令 的 常 


e -data-dir 


Maximum number of join -wan attempts. 
will retry indefinitely. 

Log level of the agent. 

Name of this node. Must be unique in 
Sets the protocol version. Defaults t 
Ignores a previous leave and attempts 
Switches agent to server mode. 
Enables logging to syslog 

Enables the built-in static web UI se 


Path to directory containing the Web 


Path to file to store agent PID 


选项 ， 如 下 : 


o 作用 : 指定 agent 储 存 状态 的 数据 目录 


o 这 是 所 有 agent 都 必须 的 


o 对 于 server 尤 其 重要 ， 因 为 他 们 必须 持久 化 集群 的 状态 


e -config-dir 
o 作用 : 指定 
o 通常 会 指 
件 存 放 的 目录 ) 
e -config-file 


定 service 的 配置 文件 和 检查 定义 所 在 的 位 置 
定 为 " 某 一 个 路 径 /consul.d"” (通常 


情况 下 ，.d 表 示 一 系列 配置 文 


o 作用 : 指定 一 个 要 装 Te 文件 


o 该 选项 可 以 配置 多 次 ， 


同 的 值 覆盖 ) 


e -dev 


进而 配置 多 个 配置 文件 (后 


边 的 会 合并 前 边 的 ， 相 


o 作用 : 创建 一 个 开发 环境 下 的 server 节 点 
o 该 参数 配置 下 ， 不 会 有 任何 持久 化 操作 ， 即 不 会 有 任何 数据 写 入 到 磁 瘟 
o 这 种 模式 不 能 用 于 生产 环境 (因为 第 二 条 ) 


e sco. 
o 作用 :1 


通知 consul server 我 们 现在 准备 加 入 的 Server 节 ， 


点 个 数 ， 访 


参数 是 为 了 延迟 日 志 复 制 的 启动 直到 我 们 指定 数量 的 Server 节 点 成 功 的 加 
入 后 启动 。 
e -node 


o 作用 : 指定 节点 在 集群 中 的 名 称 
o 该 名 称 在 集群 中 必须 是 唯一 的 (默认 采用 机 器 的 host) 
o 推荐 : 直接 采用 机 器 的 IP 
e -bind 
o 作用 : 指明 节点 的 IP 地 址 
o 有 时 候 不 指定 绑 定 IJP， 会 报 Failed to get advertise address: 
Multiple private IPs found. Please configure one. 的 异常 
e -server 
o 作用 : 指定 节点 为 server 
o 每 个 数据 中 心 (DC) 的 server 数 推荐 至 少 为 1， 至 多 为 5 
o 所 有 的 server 都 采用 raft 一 致 性 算法 来 确保 事务 的 一 致 性 和 线性 化 ， 事 务 修 
改 了 集群 的 状态 ， 且 集群 的 状态 保存 在 每 一 台 server 上 保证 可 用 性 
o Server 也 是 与 其 他 DC 交互 的 门面 (gateway) 


e -client 
o 作用 : 指定 节点 为 client， 指 定 客 户 端 接口 的 绑 定 地 址 ， 包 括 : HTTP ^ 
DNS ` RPC 


o 默认 是 127.0.0.1， 只 允许 回环 接口 访问 
o 若 不 指定 为 -server， 其 实 就 是 -client 
e -join 
o 作用 : 将 节点 加 入 到 集群 
e -datacenter 〈 老 版 本 叫 -dc，-dc 已 经 失效 ) 
o 作用 : 指定 机 器 加 入 到 哪 一 个 数据 中 心中 


如 上 ， 大 家 应 该 可 以 猜 到 ， 


使 用 -client 参数 可 指定 允许 客户 端 使 用 什么 ip 去 访问 ， 例 如 -client 
192.168.11.143 表示 可 以 使 用 http://192.168.11.143:8500/ui 去 访问 。 


我 们 尝试 一 下 : 
consul agent -dev -client 192.168.11.143 


发 现 果然 可 以 使 用 http://192.168.11.143:8500/ui 访问 了 。 


2.1.5 Consul A 474 


参考 文档 
E A 3x :https://www.consul.io/docs/agent/options.html 


Consul & 7| #2 : http://www.cnblogs.com/java-zhao/p/5378876.html 
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2.1.6 Consul à TA 


2.1.6 Consul 的 高 可 用 


Consul Cluster 集 群 架 构图 如 下 : 


Datacenter 1 





Remote DC Forwarding 


Datacenter 2 


5 


+ Replication Replication > 


Leader 
Forwarding 





这 边 准备 了 三 台 CentOS 7 的 虚拟 机 ， 主 机 规划 如 下 ， 供 参考 : 
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主机 名 称 IP 作用 EAT BAG I 


nodeO 192.168.11.143 consul server 是 
node1 192.168.11.144 consul client Lr 
node2 192.168.11.145 consul client 是 


搭建 步骤 : 
e 启动 hode0 机 器 上 的 Consul (node0 机 器 上 执行 ) 


consul agent -data-dir /tmp/nodeO -node-nodeO -bind-192.168.11.1 
43 -datacenter-dci -ui -client-192.168.11.143 -server -bootstrap 
-expect 1 


e 启动 hode1 机 器 上 的 Consul (node1 机 器 上 执行 ) 


consul agent -data-dir /tmp/node1 -node=node1 -bind-192.168.11.1 
44 -datacenter-dci -ui 


e 启动 hode2 机 器 上 的 Consul (node2 机 器 上 执行 ) 


consul agent -data-dir /tmp/node2 -node=node2 -bind=192.168.11.1 
45 -datacenter=dc1 -ui -client-192.168.11.145 


e 将 node1 节 点 加 入 到 node0 上 (node1 机 器 上 执行 ) 


consul join 192.168.11.143 


e 将 node2 节 点 加 入 到 node0 上 (node2 机 器 上 执行 ) 


consul join -rpc-addr=192.168.11.145:8400 192.168.11.143 


e 这 样 一 个 简单 的 Consul 集 群 就 搭建 完成 了 ， 在 node1 上 查看 当前 集群 节点 : 


consul members -rpc-addr=192.168.11.143:8400 


结果 如 下 
Node Address Status Type Build Protocol DC 
nodeO 192.168.11.143:8301 alive server 0.7.0 2 dc1 
node1 192.168.11.144:8301 alive client 0.7.0 2 dc1 
node2 192.168.11.145:8301 alive client 0.7.0 2 dc1 


说 明 集 群 已 经 搭建 成 功 了 。 


我 们 分 析 一 下 ， 为 什么 步 需要 加 -rpc-addr 选项 ， 而 第 4 步 不 需要 加 
E A ee S MM o T 
DNS^RPC: * consul join > consul members 都 是 通过 RPC 与 Consul 交 
互 的 。 


访问 集群 


如 上 ， 我 们 三 个 节点 都 加 了 -ui 参数 启动 了 内 建 的 界面 。 我 们 可 以 通 

id: http://192.168.11.143:8500/ui/ 或 

者 http://192.168.11.145:8500/ui/ 进行 访问 ， 也 可 以 在 node1 机 器 上 通 

过 http://127.0.0.1:8500/ui/ 进行 访问 ， 原 因 是 node1 没 有 开启 远程 访问 ， 
三 种 访问 方式 结果 是 一 致 的 ， 如 下 


node0 19 


any status Y EXPAND 


SERVICES 


consul 
H node1 ) services 
a node2 ) services CHECKS 
Serf Health Status seriHealt 








NOTES 
OUTPUT 


Agent alive and reachable 


LOCK SESSIONS 
No sessions 
NETWORK TOMOGRAPHY 





P 


di im. 


2.1.6 Consul 3 TA 


参考 文档 : 
Consul E 7 3075 : https://www.consul.io/intro/getting-started/install.html 


Consul 系列 博文 : http://www.cnblogs.com/java- 
zhao/archive/2016/04/13/5387 105.html 


使 用 consul 实 现 分 布 式 服务 注册 和 发 
IL : http://www.tuicool.com/articles/M3QFven 
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2.2 服务 提供 者 


首先 说 明 一 下 ， 为 了 便于 讲解 ， 本 节 之 后 ， 如 无 特殊 说 明 ， 均 是 以 单 点 的 Eureka 进 
行 讲解 的 。 


服务 提供 者 和 服务 消费 者 
下 面 这 张 表格 ， 简 单 描述 了 服务 提供 者 /消费 者 是 什么 : 


名 词 概念 
服务 提供 者 服务 的 被 调用 方 (PP: 为 其 他 服务 提供 服务 的 服务 ) 
服务 消费 者 服务 的 调用 方 ( 即 : 依赖 其 他 服务 的 服务 ) 


服务 提供 者 代码 示例 


这 是 一 个 稍微 有 点 复杂 的 程序 。 我 们 使 用 Spring-data-jpa 操 作 h2 数 据 库 ， 同 时 将 该 
服务 注册 到 注册 中 心 Eureka 中 。 


e 创建 一 个 Maven 工 程 ， 并 在 pom.xml 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns-"http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-provider-user</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId- 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<!-- 添加 Eureka 的 依赖 --> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter -eureka</artifactId> 
</dependency> 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-data-jpa</artifactId> 
</dependency> 


<dependency> 
«groupId»com.h2databasec/groupId» 
<artifactId>h2</artifactId> 
</dependency> 


<dependency> 
<groupid>org.springframework .boot</groupId> 
<artifactId>spring-boot-starter-actuator</artifactId> 
</dependency> 
</dependencies> 
</project> 


e 配置 文件 : application.yml 


server: 
port: 8000 
spring: 
application: 
name: microservice-provider-user # 项 目 名 称 尽量 用 小 写 
jpa: 
generate-ddl: false 
show-sql: true 
hibernate: 
ddl-auto: none 


datasource: # 指定 数据 源 
platform: h2 # 指定 数据 源 类 型 
schema: classpath:schema.sql # 指定 h2 数 据 库 的 建 表 脚 本 
data: classpath:data.sql # 指定 h2 数 据 库 的 Insert 脚 本 
logging: 
level: 
root: INFO 


org.hibernate: INFO 
org. hibernate. type.descriptor.sgql.BasicBinder: TRACE 
org. hibernate.type.descriptor.sql.BasicExtractor: TRACE 
com.itmuch.youran.persistence: ERROR 
eureka: 
client: 
serviceUrl: 
defaultZone: http://discovery:8761/eureka/ # 指定 注册 中 心 
的 地 址 
instance: 
preferIpAddress: true 


e € &i&6] : schema.sq| 


drop table user if exists; 
create table user (id bigint generated by default as identity, u 
sername varchar(255), age int, primary key (id)); 


e 16/478 6] : data.sql 


2.2 服务 提供 者 


insert into user (id, username, age) values (1,'Tom',12); 

insert into user (id, username, age) values (2,'Jerry', 23); 
insert into user (id, username, age) values (3,'Reno', 44); 
insert into user (id, username, age) values (4,'Josh', 55); 


e DAO: 


QRepository 

public interface UserRepository extends JpaRepository«User, Long 
> 

} 


e Controller : 


NO 


Je 
STEMS 
* (D 测试 服务 实例 的 相关 内 容 
* (2) 为 后 来 的 服务 做 提供 
* @author eacdy 
ar A 
@RestController 
public class UserController { 
@Autowired 
private DiscoveryClient discoveryClient; 
@Autowired 
private UserRepository userRepository; 


/** 
* ik : @GetMapping("/{id}") spring 4.3 的 新 注解 等 价 于 : 
* @RequestMapping(value = "/id", method = RequestMethod.GET ) 
* 类 似 的 注解 还 有 @PostMapping 等 等 
* @param id 
* @return user 信 息 
YA 
@GetMapping("/{id}") 
public User findById(@PathVariable Long id) { 
User findOne = this.userRepository.findOne(id); 
return findOne; 


jee 
* 本 地 服务 实例 的 信息 
* @return 
n. 
QGetMapping("/instance-info") 
public ServiceInstance showInfo() ( 
ServiceInstance localServiceInstance - this.discoveryClient. 
getLocalServiceInstance(); 
return localServiceInstance; 


e 实体 类 : 


@Entity 
public class User { 
@Id 
@GeneratedValue(strategy = GenerationType.AUTO) 
private Long id; 
@Column 
private String username; 
@Column 
private Integer age; 


// getters and setters 


e 编写 Spring Boot’ 4424F > 3$ 3t @EnableDiscoveryClientiz AF > Bp TA% 
microservice-provider-user/k 4 i= At $| Eureka k do 


@SpringBootApplication 
@EnableDiscoveryClient 
public class UserApplication { 
public static void main(String[] args) { 
SpringApplication.run(UserApplication.class, args); 


至 此 ， 代 码 编写 完成 。 


测试 
我 们 依次 启动 Eureka 服 务 和 microservice-provider-user 服 务 。 


访问 : http://localhost:8761， 如 下 图 。 我 们 会 发 现 microservice-provider-user 服 务 
已 经 被 注册 到 了 Eureka 上 面 了 。 


Instances currently registered with Eureka 


Application AMIs Availability Zones Status 


MICROSERVICE-PROVIDER-USER n/a (1) (1) UP (1) - QH-20160301NAVT-microservice-provider-user-8000 


访问 : http://localhost:8000/instance-info > 3& E128 R : 


MOSES 19» T5959 

UPOKEE 80009, 

"metadata": {}, 

“Ue > Sete 7/192. 168-02 S8000 
"secure": false, 

"serviceld": "microservice-provider-user" 


访问 : http://discovery:8000/1 > RENE R : 


{ 
uno [eae al 
"username": "Tom", 
"age": 12 

} 


服务 注册 到 高 可 用 Eureka 


如 果 Eureka 是 高 可 用 的 ， 那 么 各 个 微服 务 配置 只 需要 将 defaultzone Aw 
PERRIS 


eureka: 
client: 
serviceUrl: 
defaultZone: http://peer1:8761/eureka/,http://peer2:8762/e 
ureka 


代码 地 址 ( 任 选 其 一 ) 


http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice- 
provider-user https://github.com/eacdy/spring-cloud- 
study/tree/master/microservice-provider-user 


CD 
CO 


2.2 服务 提供 者 


40 


2.3 服务 消费 者 


上 文 我 们 创建 了 注册 中 心 ， 以 及 服务 的 提供 者 microservice-provider-user， 并 成 功 
地 将 服务 提供 者 注册 到 了 注册 中 心 上 。 

要 想 消费 microservice-provider-user 的 服务 是 很 简单 的 ， 我 们 只 需要 使 用 
RestTemplate 即 可 ， 或 者 例如 HttpClient 之 类 的 http 工 具 也 是 可 以 的 。 但 是 在 集群 环 
境 下 ， 我 们 必然 是 每 个 服务 部 署 多 个 实例 ， 那 么 服务 消费 者 消费 服务 提供 者 时 的 负 
载 均衡 又 要 如 何 做 呢 ? 


准备 工作 


1. 启动 注册 中 心 : microservice-discovery-eureka 
2. 启动 服务 提供 方 : microservice-provider-user 
3. 修改 microservice-provider-user 的 端口 为 8001， 另 外 启动 一 个 实例 


此 时 ， 访 问 http://discovery:8761 


Instances currently registered with Eureka 


Application AMIs Availability Zones Status 

MICROSERVICE-PROVIDER-USER n/a (2) (2) UP (2) - QH-20160301NAVT:microservice-provider-user:8001 , QH-20160301NAVT:microservice-provider-user-8000 
可 以 在 Eureka 中 看 到 microservice-provider-user 有 两 个 实例 在 运行 。 
下 面 我 们 创建 一 个 新 的 微服 务 (microservice-consumer-movie-*) ， 负 载 均衡 地 消 
费 microservice-provider-user 的 服务 。 


2.3.1 Ribbon 


Ribbon 22 


Ribbon 是 Netflix 发 布 的 开源 项 目 ， 主 要 功能 是 提供 客户 端的 软件 负载 均衡 算法 ， 将 
Netflix 的 中 间 层 服务 连接 在 一 起 。Ribbon 客 户 端 组 件 提供 一 系列 完善 的 配置 项 如 连 
接 超 时 ， 重 试 等 。 简 单 的 说 ， 就 是 在 配置 文件 中 列 出 Load Balancer 后 面 所 有 的 机 
器 ，Ribbon 会 自动 的 帮助 你 基于 某 种 规则 (如 简单 轮 询 ， 随 机 连接 等 ) 去 连接 这 些 
机 器 。 我 们 也 很 容易 使 用 Ribbon 实 现 自 定义 的 负载 均衡 算法 。 简 单 地 说 ，Ribbon 是 
一 个 客户 端 负载 均衡 器 。 


Ribbon 工 作 时 分 为 两 步 : 第 一 步 先 选择 Eureka Server, 它 优先 选择 在 同一 个 Zone 

且 负 载 较 少 的 Server ; 第 二 步 再 根据 用 户 指定 的 策略 ， 在 从 Server 取 到 的 服务 注册 
列表 中 选择 一 个 地 址 。 其 中 Ribbon 提 供 了 多 种 策略 ， 例 如 轮 询 、 随 机 、 根 据 响 应 时 
间 加 权 等 。 


Ribbon 代 码 示 例 


创建 一 个 Maven 项 目 ， 并 在 pom.xml 中 加 入 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactid>microservice-consumer -movie-ribbon</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId» 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
«artifactId»spring-cloud-starter-eureka«c/artifactId» 
«/dependency» 


<!-- 整合 ribbon --» 

«dependency» 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter -ribbon</artifactId> 

</dependency> 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-actuator</artifactId> 
</dependency> 
</dependencies> 
</project> 


启动 类 : MovieRibbonApplication.java ° 4%] @LoadBalanced iz Af > A 
RestTemplatest È 负载 均衡 的 能 力 。 


@SpringBootApplication 
@EnableDiscoveryClient 
public class MovieRibbonApplication { 
jee 
* 实例 化 RestTemplate， 通 过 @LoadBalanced 注 解 开启 均衡 负载 能 力 . 
* @return restTemplate 
YA 
@Bean 
@LoadBalanced 
public RestTemplate restTemplate() { 
return new RestTemplate(); 


public static void main(String[] args) ( 
SpringApplication.run(MovieRibbonApplication.class, args); 


实体 类 : User.java 
public class User { 
private Long id; 
private String username; 


private Integer age; 


// getters and setters 


Ribbon 的 测试 类 : RibbonService.java 


@Service 

public class RibbonService { 
@Autowired 
private RestTemplate restTemplate; 


public User findById(Long id) ( 
// http:// 服 务 提供 者 的 ServiceId/ur1l 
return this.restTemplate.getForObject("http://microservice-p 
rovider-user/" + id, User.class); 


} 


controller : RibbonController.java 


QRestController 

public class RibbonController ( 
@Autowired 
private RibbonService ribbonService; 


@GetMapping("/ribbon/{id}") 


public User findById(@PathVariable Long id) { 
return this.ribbonService.findById(id); 


application.yml 


server: 


port: 8010 
spring: 
application: 
name: microservice-consumer -movie-ribbon 
eureka: 
client: 
serviceUrl: 


defaultZone: http://discovery:8/61/eureka/ 


instance: 
preferIpAddress: true 


启动 后 ， 访 问 多 次 http://localhost:8010/ribbon/1， 返 回 结果 : 


{ 
dono eene 
"username": "Tom", 
"aget 12 

} 


然后 打开 两 个 microservice-provider-user 实 例 的 控制 台 ， 发 现 两 个 实例 都 输出 了 类 


Hibernate: select userO .id as idi 0 0 userO .age as age2 0 0 


EM 


, UserO .username as username3 0 O from user userO where userO 


.idz? 
2016-09-13 21:38:56.719 TRACE 17404 --- [nio-8000-exec-1] o.h.ty 
pe.descriptor.sql.BasicBinder : binding parameter [1] as [B 
IGINT] - [1] 
2016-09-13 21:38:56.720 TRACE 17404 --- [nio-8000-exec-1] o.h.ty 
pe.descriptor.sql.BasicExtractor : extracted value ([age2 0 0_ 
] : [INTEGER]) - [12] 
2016-09-13 21:38:56.720 TRACE 17404 --- [nio-8000-exec-1] o.h.ty 
pe.descriptor.sql.BasicExtractor : extracted value ([username3 
_@_0_] : [VARCHAR]) - [Tom] 
2016-09-13 21:39:10.588 INFO 17404 --- [trap-executor-0] c.n.d. 
s.r.aws.ConfigClusterResolver : Resolving eureka endpoints 


via configuration 
至 此 ， 我 们 已 经 通过 Ribbon 在 客户 端 侧 实现 了 均衡 负载 。 


代码 地 址 ( 任 选 其 一 ) : 


Ribbon 代 码 地 址 : 


http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice- 
consumer-movie-ribbon https://github.com/eacdy/spring-cloud- 
study/tree/master/microservice-consumer-movie-ribbon 


2.3.2. Feign 


Feign #4 

Feign 有 是 一 个 声明 式 的 web service 客 户 端 ， 它 使 得 编写 Web service € P 3 BAB 
昂 。 创 建 接 口 ， 为 接口 添加 注解 ， 即 可 使 用 Feign。Feign 可 以 使 用 Feign 注 解 或 者 
JAX-RS 注 解 ， 还 支持 热 插 技 的 编码 器 和 解码 器 。Spring Cloud 为 Feign 添 加 了 
Spring MVC 的 注解 支持 ， 并 整合 了 Ribbon 和 Eureka 来 为 使 用 Feign 时 提供 负载 均 
BT o 


i& B : http://projects.spring.io/spring-cloud/docs/1.0.3/spring- 
cloud.html#spring-cloud-feign 


Feign: 4] 


创建 一 个 Maven 项 目 ， 并 在 pom.xml 添 加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-consumer -movie -feign</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId» 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
«artifactId»spring-cloud-starter-eureka«c/artifactId» 
«/dependency» 


«dependency» 
«groupId»org.springframework.cloud«c/groupId» 
«artifactId»spring-cloud-starter-feignc/artifactlId» 

«/dependency» 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-actuator</artifactId> 

</dependency> 

</dependencies> 
</project> 


启动 类 : MovieFeignApplication.java 


/** 
* 使 用 @EnableFeignClients 开 启 Feign 
* @author eacdy 
WA 
@SpringBootApplication 
@EnableFeignClients 
@EnableDiscoveryClient 
public class MovieFeignApplication { 
public static void main(String[] args) { 
SpringApplication.run(MovieFeignApplication.class, args); 


实体 类 : User.java 


public class User { 
private Long id; 
private String username; 
private Integer age; 


// getters and setters 


Feign 测 试 类 : UserFeignClient.java > 


/** 
* 4&HOFeignClient("microservice-provider-user")Ef/f£Zpxmicroserv 
ice-provider-user 服 务 ， 还 可 以 使 用 Ur1 参 数 指 定 一 个 URL。 
* @author eacdy 
YA 
@FeignClient(name = "microservice-provider-user") 
public interface UserFeignClient { 
@RequestMapping("/{id}") 
public User findByIdFeign(@RequestParam("id") Long id); 


Feign 的 测试 类 : FeignController.java 


C1 
) 


929 Eaimn 
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QRestController 
public class FeignController ( 
@Autowired 
private UserFeignClient userFeignClient; 


@GetMapping("feign/{id}") 

public User findByIdFeign(@PathVariable Long id) { 
User user = this.userFeignClient.findByIdFeign(id); 
return user; 


application.yml 


server: 
port: 8020 
spring: 
application: 
name: microservice-consumer-movie-feign 
eureka: 
client: 
serviceUrl: 
defaultZone: http://discovery:8/61/eureka/ 
instance: 
preferIpAddress: true 
ribbon: 
eureka: 
enabled: true # 默认 为 true。 如 果 设 置 为 false，Ribbon 将 不 
会 从 Eureka 中 获得 服务 列表 ， 而 是 使 用 静态 配置 的 服务 列表 。 静 态 服务 列表 可 使 用 : < 
client>.ribbon.1istofServers 来 指定 。 参 考 : http://projects.spring.i 
o/spring-cloud/docs/1.0.3/spring-cloud.html#spring-cloud-ribbon- 





without-eureka 


### 4 :https://spring.io/guides/gs/client-side-load-balancing/ 


同样 的 ， 启 动 该 应 用 ， 多 次 访问 http://localhost:8020/feign/1， 我 们 会 发 现 和 Ribbon 
示例 一 样 实现 了 负载 均衡 。 


2.3.2. Feign 


代码 地 址 ( 任 选 其 一 ) 


Feign 代 码 地 址 : 


http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice- 
consumer-movie-feign https://github.com/eacdy/spring-cloud- 
study/tree/master/microservice-consumer-movie-feign 
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2.4 熔断 器 


在 微服 务 架构 中 通常 会 有 多 个 服务 层 调用 ， 基 础 服务 的 故障 可 


能 会 导致 级 联 故 障 


AGH 


进而 造成 整个 系统 不 可 用 的 情况 ， 这 种 现象 被 称 为 服务 雪崩 效应 。 服 务 雪崩 效应 是 
一 种 因 “ 服 务 提 供 者 "的 不 可 用 导致 "服务 消费 者 "的 不 可 用 ,并 将 不 可 用 逐渐 放大 的 过 


程 。 


如 果 下 图 所 示 : A 作 为 服务 提供 者 ，B 为 A 的 服务 消费 者 ，C 和 D 是 B 的 服务 消费 者 。 
A 不 可 用 引起 了 B 的 不 可 用 ， 并 将 不 可 用 像 滚雪球 一 样 放大 到 C 和 DD 时 ， 雪 崩 效 应 就 


WB mT ° 


A 不 可 用 


AB 不 可 用 


系统 不 可 用 


熔断 器 (CircuitBreaker ) 








时 间 推 移 
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熔断 器 的 原理 很 简单 ， 如 同 电力 过 载 保 护 器 。 它 可 以 实现 快速 失败 ， 如 果 它 在 一 段 
时 间 内 侦 测 到 许多 类 似 的 错误 ， 会 强迫 其 以 后 的 多 个 调用 快速 失败 ， 不 再 访问 远程 
服务 器 ， 从 而 防止 应 用 程序 不 断 地 尝试 执行 可 能 会 失败 的 操作 ， 使 得 应 用 程序 继续 
执行 而 不 用 等 待 修正 错误 ， 或 者 浪费 CPU 时 间 去 等 到 长 时 间 的 超时 产生 。 熔 断 器 也 
可 以 使 应 用 程序 能 够 诊断 错误 是 否 已 经 修正 ， 如 果 已 经 修正 ， 应 用 程序 会 再 次 尝试 
调用 操作 。 


熔断 器 模式 就 像 是 那些 容易 导致 错误 的 操作 的 一 种 代理 。 这 种 代理 能 够 记录 最 近 调 
用 发 生 错误 的 次 数 ， 然 后 决定 使 用 允许 操作 继续 ， 或 者 立即 返回 错误 。 


熔断 器 开关 相互 转换 的 逻辑 如 下 图 : 


成 功 


[| 


失败 [ 低 于 开关 闭 值 ] C Sep] -失败 达到 开关 闭 值 . 打开 


熔断 器 时 间 窗 结束 





2.4.1. Hystrix 


Hystrix 


在 Spring Cloud 中 使 用 了 Netflix 开 发 的 Hystrix 来 实现 熔断 器 。 下 面 我 们 依然 通过 几 
个 简单 的 代码 示例 ， 进 入 Hystrix 的 学 习 : 


通用 方式 使 用 Hystrix 


代码 示例 : 


新 建 一 个 Maven 项 目 ， 在 pom.xml 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


«artifactId»microservice-consumer-movie-ribbon-with-hystrix«/a 
rtrtactrd- 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId- 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter-eureka</artifactId> 
</dependency> 


<!-- 整合 ribbon --> 

<dependency> 
<groupiId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter -ribbon</artifactId> 

</dependency> 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-actuator«/artifactId» 
«/dependency» 


<!-- 整合 hystrix --> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter -hystrix</artifactId> 
</dependency> 
</dependencies> 
</project> 


启动 类 : MovieRibbonHystrixApplication.java > 1& F] @EnableCircuitBreaker i #7 
局 断路 器 功能 : 


/** 
* 4% M @EnableCircuitBreaker z# 
* @author eacdy 
P 

QSpringBootApplication 


+a 
ay 
& 
c 
Ed 
Ens 
过 
a> 
GG 


QEnableDiscoveryClient 
QEnableCircuitBreaker 
public class MovieRibbonHystrixApplication { 
jee 
* 实例 化 RestTemplate， 通 过 @LoadBalanced 注 解 开启 均衡 负载 能 
* @return restTemplate 
=y 
@Bean 
@LoadBalanced 
public RestTemplate restTemplate() { 
return new RestTemplate(); 


public static void main(String] args) f 
SpringApplication.run(MovieRibbonHystrixApplication.class, a 
rgs); 
j 


实体 类 : User.java 


public class User ( 
private Long id; 
private String username; 
private Integer age; 


// getters and setters 


Hystrix 4- & : RibbonHystrixService.java > 4% M (HystrixCommand x Af 48 © 25 HK 
方法 发 生 弄 常 时 调用 的 方法 


@Service 

public class RibbonHystrixService { 
@Autowired 
private RestTemplate restTemplate; 


private static final Logger LOGGER = LoggerFactory.getLogger(R 
ibbonHystrixService.class); 


/** 
* 使 用 @HystrixCommand 注 解 指定 当 该 方法 发 生 异 常 时 调用 的 方法 
* @param id id 
* Qreturn 通过 id 和 查询 到 的 用 户 
=y 
QHystrixCommand(fallbackMethod = "fallback") 
public User findById(Long id) { 
return this.restTemplate.getForObject("http://microservice-p 
rovider-user/" + id, User.class); 


} 


J** 
* hystrix fallbackz X 
* (param id id 
* @return 默认 的 用 户 
YA 
public User fallback(Long id) ( 
RibbonHystrixService.LOGGER.info(" JF E E » tA fallbackZ k > 4 
jaan Baa f}" aid); 
User user = new User(); 
user.setId(-1L); 
user.setUsername("default username"); 
user.setAge(9?); 
return user; 


controller : RibbonHystrixController.java 


@RestController 
public class RibbonHystrixController { 
@Autowired 
private RibbonHystrixService ribbonHystrixService; 


@GetMapping("/ribbon/{id}") 
public User findById(@PathVariable Long id) { 
return this.ribbonHystrixService.findById(id); 


application.yml 


server: 
port: 8011 
spring: 
application: 
name: microservice-consumer -movie-ribbon-with-hystrix 
eureka: 
client: 
serviceUrl: 
defaultZone: http://discovery:8761/eureka/ 
instance: 
hostname: ribbon # 此 处 ，preferIpAddress 不 设置 或 者 设 为 
false， 不 能 设 为 true， 否 则 影响 turbine 的 测试 。turbine 疹 在 的 问题 : eureka.i 


nstance.hostname 一 致 时 只 能 检测 到 一 个 节点 ， 会 造成 turbine 数 据 不 完整 
NAE: 

1. 启动 注册 中 心 : microservice-discovery-eureka 

2. 启动 服务 提供 方 : microservice-provider-user 

3. 启动 服务 消费 方 : microservice-consumer-movie-ribbon-with-hystrix 


4. 访问 : http://localhost:8011/ribbon/1， 获 得 结 


A: {"id":1, "username":"Tom", "age" :12) 


5. 关闭 服务 提供 方 : microservice-provider-user > 77 19) 
http://localhost:8011/ribbon/1 » RAFAH: {"id":-1, "username": "default 
username","age":0} ， 另 外 日 志 打 
印 : c.i.c.s.u.service.RibbonHystrixService : 异常 发 生 ， 进 入 
fallback 方 法 ， 接 收 的 参数 : id =1 。 


注意 : 
1. 本 示例 代码 在 microservice-consumer-movie-ribbon 基 础 上 修改 而 来 
2. 如 对 本 示例 涉及 的 知识 点 有 疑难 ， 请 查看 上 一 章 《 服 务 消费 者 》 
代码 地 址 ( 任 选 其 一 ) 


1. http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice- 
consumer-movie-ribbon-with-hystrix 

2. https://github.com/eacdy/spring-cloud-study/tree/master/microservice- 
consumer-movie-ribbon-with-hystrix 


Feign 使 用 Hystrix 


代码 示例 


在 Feign 中 使 用 Hystrix 是 非常 简单 的 事情 ， 因 为 Feign 已 经 集成 了 Hystrix。 我 们 使 用 
microservice-consumer-movie-feign-with-hystrix 项 目的 代码 做 一 点 修改 ， 将 其 中 的 
UserClient.java 修 改 为 如 下 即 可 : 


2.4.1. Hystrix 


/** 
* 使 用 @FeignClient 注 解 的 fallback 属 性 ， 指 定 fallback 类 
* @author eacdy 
WA 
@FeignClient(name = "microservice-provider-user", fallback = Hys 
trixClientFallback.class) 
public interface UserFeignHystrixClient { 
@RequestMapping("/{id}") 
public User findByIdFeign(@RequestParam("id") Long id); 


J** 
* 这 边 采 取 了 和 Spring Cloud 官 方 文档 相同 的 做 法 ， 将 fallback 类 作为 内 部 类 
放 入 Feign 的 接口 中 ， 当 然 也 可 以 单独 写 一 个 fallback 类 。 
* @author eacdy 
WA 
@Component 
static class HystrixClientFallback implements UserFeignHystrix 
Client { 
private static final Logger LOGGER = LoggerFactory.getLogger 
(HystrixClientFallback.class); 


/** 
* hystrix fallback7 X 
* @param id id 
* @return 默认 的 用 户 
YA 
@Override 
public User findByIdFeign(Long id) { 
HystrixClientFallback.LOGGER.info("+% 24 > 进入 fallback 方 法 
| 接收 的 参数 : id = {}", id); 
User user = new User(); 
user.setId(-1!); 
user.setUsername("default username"); 
user.setAge(9); 
return user; 
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2.4.1. Hystrix 


这 样 就 完成 了 ， 是 不 是 很 简单 呢 ? 测试 过 程 类 似 通用 方式 。 
注意 : 


1. 本 示例 代码 在 microservice-consumer-movie-feign 基 础 上 修改 而 来 
2. 如 对 本 示例 涉及 的 知识 点 有 疑难 ， 请 查看 上 一 章 《 服 务 消费 者 》 


代码 地 址 ( 任 选 其 一 ) 


1. http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice- 
consumer-movie-feign-with-hystrix 

2. https://github.com/eacdy/spring-cloud-study/tree/master/microservice- 
consumer-movie-feign-with-hystrix 


参考 文档 : 


1. https://msdn.microsoft.com/en-us/library/dn589784.aspx 

2. http://martinfowler.com/bliki/CircuitBreaker.html 

3. http://particular.net/blog/protect-your-software-with-the-circuit-breaker- 
design-pattern 

4. https://github.com/Netflix/Hystrix/wiki/How-it-Works#flow-chart 

5. https://segmentfault.com/a/1190000005988895 
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2.4.2. Hystrix Dashboard 


iy Us de 
Hystrix 监控 
除了 隔离 依赖 服务 的 调用 以 外 ，Hystrix 还 提供 了 近 实时 的 监控 ，Hystrix 会 实时 、 累 


加 地 记录 所 有 关于 HystrixCommand 的 执行 信息 ， 包 括 每 秒 执行 多 少 请 求 多 少 成 
功 ， 多 少 失败 等 。Netflix 通 过 hystrix-metrics-event-stream 项 目 实现 了 对 以 上 指标 的 


上 文 提 到 的 microservice-consumer-movie-ribbon-with-hystrix 项 目 已 经 具 
备 对 Hystrix 监 控 的 能 力 ， 下 面 我 们 进入 测试 。 


测试 步骤 


1. 启动 : microservice-discovery-eureka 
2. 启动 : microservice-provider-user 
3. 启动 : microservice-consumer-movie-ribbon-with-hystrix 


4. 访问 : http://localhost:8011/ribbon/1 > ZB: 该 步 又 不 能 省 略 ， 因 为 如 果 应 用 
的 所 有 接口 都 未 被 调用 ， 将 只 会 看 到 一 个 ping 


5. 访问 : http:Wlocalhost:8011/hystrix.stream， 可 以 看 到 类 似 如 下 输出 : 
data: {"type":"HystrixCommand", "name":"findById","group":"Ri 
bbonHystrixService", 'currentTime":1472658867784, "isCircuitBr 


eakerOpen": false, "errorPercentage":0,"errorCount":0, "request 
Count":0, "rollingCountBadRequests":0....} 


并 且 会 不 断 刷 新 以 获取 实时 的 监控 数据 。 但 是 纯 文字 的 输出 可 读 性 实在 是 太 差 ， 运 
维 人 员 很 难 一 眼看 出 系统 当前 的 运行 状态 。 那 么 是 不 是 有 可 视 化 的 工具 呢 ? 


Hystrix Dashboard 


Hystrix Dashboard 可 以 可 视 化 查看 实时 监控 数据 。 我 们 可 以 下 载 hystrix-dashboard 
的 war 包 部 署 到 诸如 Tomcat 之 类 的 容器 中 ， 本 文 不 做 浆 述 。 另 外 Spring Cloud 也 提 
供 了 Hystrix Dashboard 的 整合 ， 下 面 我 们 看 看 Spring Cloud 是 怎么 玩 转 Hystrix 
Dashboard 的 。 


新 建 一 个 maven 项 目 ， 在 pom.xml 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
XSi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-hystrix-dashboard</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId- 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
<groupiId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter -hystrix-dashboard</artifa 
ctild= 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-actuator«/artifactId» 
</dependency> 
</dependencies> 
</project> 


编写 启动 类 : HystrixDashboardApplication.java 


2.4.2. Hystrix Dashboard 


/** 

* 测试 步骤 : 

* 1. 访问 http://localhost:8030/hystrix.stream 可 以 查看 Dashboard 

* 2. d Ea MAA: http:// 想 监控 的 服务 :端口 /hystrix.stream 进 行 测 
试 

* 注意 : 首先 要 先 调用 一 下 想 监控 的 服务 的 API， 和 否则 将 会 显示 一 个 空 的 图 表 ， 

* @author eacdy 

YA 
@SpringBootApplication 
@EnableHystrixDashboard 
public class HystrixDashboardApplication { 

public static void main (stringi args) «4 

new SpringApplicationBuilder(HystrixDashboardApplication.cla 

ss).web(true).run(args); 


} 


配置 文件 : application.yml 


Spring: 
application: 
name: hystrix-dashboard 
server: 
port: 8030 


启动 后 ， 访 问 http://localhost:8030/hystrix.stream 将 会 看 到 如 下 界面 : 
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Hystrix Dashboard 


localhost:8011/hystrix.stream 


Cluster via Turbine (default cluster): http://turbine-hostname:port'turbine.stream 
Cluster via Turbine (custom cluster): http://turbine-hostname:port/turbine.stream?cluster=[clusterName] 
Single Hystrix App: http://hystrix-app:port/hystrix.stream 


Delay: | ms Title 





| Monitor Stream | 


此 时 ， 我 们 在 输入 框 中 输入 http://localhost:8011/hystrix.stream ， 并 随意 设置 一 个 
Title 后 ， 点 击 Monitor Stream 按 钮 ， 会 出 现 如 下 界面 : 


Hystrix Stream: movie 


Circuit 





findByld 
0|0 0.0 % 
0/0 


0 

Host: 0.0/s 
Cluster: 0.0/s 
Circuit Closed 


Hosts 1 90th 32ms 
Median 32ms 99th 32ms 
Mean 32ms  995th 32ms 





Thread Pools Sort: Alphabetical | Volume | 


RibbonHystrixService 

Host: 0.0/s 

Cluster: 0.0/s 

Active 0 Max Active 0 
Queued 0 Executions 0 
Pool Size 2 Queue Size 5 


此 时 我 们 会 看 到 findByld 这 个 API 的 各 种 指标 。Hystrix Dashboard Wiki 上 详细 说 明 
了 图 上 每 个 指标 的 含义 ， 如 下 图 : 


RA 
UU 


2.4.2. Hystrix Dashboard 


circle color and size represent Error percentage of 





health and traffic volume SubscriberGetAccount "i SS DON 
NI 200,545 | 19 | 0 96 
0 94 
0 Reguest rate 
gi Host: 54.0/s E d 
wa Cluster: 20,056.0/s 
2 minutes of request rate to Circuit Closed . 
show relative changes in traffic ^  , Hosts 370 90th 10ms Circuit-breaker 
_— Median ims 99th 44ms status 
a Mean 4ms 99.5th 61ms 


a " 


hosts reporting from cluster j 
last minute latency percentiles 


Rolling 10 second counters 
with 1 second granularity 


Successes 200,545 | 19 Thread timeouts 
Short-circuited (rejected) 0 | 94 Thread-pool Rejections 
0 Failures/Exceptions 


此 时 ， 我 们 可 以 尝试 将 microservice-provider-user 停 止 ， 然 后 重复 访问 多 
次 http://localhost:8011/ribbon/1 (20 次 以 上 ) ， 会 发 现 断路 器 状态 会 变 为 开局 。 


代码 地 址 ( 任 选 其 一 ) : 
http://git.oschina.net/itmuch/spring-cloud-study/tree/master/microservice- 
hystrix-dashboard 


https://github.com/eacdy/spring-cloud-study/tree/master/microservice-hystrix- 
dashboard 


TIPS 


1. Hystrix 的 监控 数据 默认 是 保存 在 每 个 实例 的 内 存 中 的 ，Spring Bootie T 2 FP 
方式 ， 可 以 导入 到 Redis、TSDB 以 供 日 后 分 析 使 用 。 


2. 我 们 启动 前 文 的 microservice-consumer-movie-feign-with-hystrix 项 
目 后 发 现 其 访问 localhost:8021/hystrix.stream ， 是 404， 查 看 pom.xml 依 赖 
树 ， 发 现 其 没有 依赖 hystrix-metrics-event-stream 项 目 。 故 而 添加 依赖 : 
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2.4.2. Hystrix Dashboard 


<!-- 整合 hystrix， 其 实 feign 中 自 带 了 hystrix， 引 入 该 依赖 主要 是 为 了 使 用 
其 中 的 hystrix-metrics-event-stream， 用 于 dashboard --> 


<dependency> 
<grouplId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter -hystrix</artifactId> 
</dependency> 


并 在 启动 类 上 添加 @EnableCircuitBreaker 注解 即 可 。 详 见 项 
E microservice-consumer-movie-feign-with-hystrix-stream ， 因 为 这 
不 是 本 文 的 讨论 重点 ， 故 而 只 做 扩展 阅读 。 


microservice-consumer-movie-feign-with-hystrix-stream 代码 地 址 
(=%—) 
https://github.com/eacdy/spring-cloud-study/tree/master/microservice- 


consumer-movie-feign-with-hystrix-stream 


https://git.oschina.net/itmuch/spring-cloud- 
study/tree/master/microservice-consumer-movie-feign-with-hystrix- 
stream 
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2.4.3. Turbine 


Turbine 
在 复杂 的 分 布 式 系统 中 ， 相 同 服务 的 节点 经 常 需要 部 署 上 百 甚至 上 千 个 ， 很 多 时 
候 ， 运 维 人 员 希 望 能 够 把 相同 服务 的 节点 状态 以 一 个 整体 集群 的 形式 展现 出 来 ， 这 
样 可 以 更 好 的 把 握 整 个 系统 的 状态 。 为 此 ，Netflix 提 供 了 一 个 开源 项 目 

(Turbine) 来 提供 把 多 个 hystrix.stream 的 内 容 聚 合 为 一 个 数据 源 供 Dashboard 展 
o 


和 Hystrix Dashboard —€ > Turbine T AT Zwar 38-4 8I Web S * AT KE 
述 。 下 面 讨论 Spring Cloud /& 4 1& M Turbine > 


代码 示例 


新 建 Maven 项 目 ， 并 在 pom.xml 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation-'http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-hystrix-turbine</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId» 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactIid>spring-cloud-starter -turbine</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-netflix-turbine</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-actuator</artifactId> 
</dependency> 
</dependencies> 
</project> 


启动 类 : TurbineApplication.java 


/** 
* 通过 Q@EnableTurbine 接 口 ， 激 活 对 TUrbine 的 支持 。 
* @author eacdy 
ued 
@SpringBootApplication 
@EnableTurbine 
public class TurbineApplication { 
public static void main(String[] args) { 


new SpringApplicationBuilder(TurbineApplication.class).web(t 
rue).run(args); 


} 


配置 文件 : application.yml 


2.4.3. Turbine 


spring: 

application.name: microservice-hystrix-turbine 
server: 

port: 8031 
security.basic.enabled: false 
turbine: 

aggregator: 

clusterConfig: default # 指定 聚合 哪些 集群 ， 多 个 使 用 ", "PS ^ Ri 

为 default。 可 使 用 http://.../turbine.stream?cluster={clusterConfig 
le] 

appConfig: microservice-consumer-movie-feign-with-hystrix-stre 
am,microservice-consumer-movie-ribbon-with-hystrix ### 配置 EUrek 
a 中 的 ServiceId 列 表 ， 衣 明 监 控 哪 些 服务 

clusterNameExpression: new String("default") 

# 1. clusterNameExpression 指 定 集群 名 称 ， 默 认 表 达 式 appName ; 此 时 : tu 
rbine.aggregator .clusterConfig 需 要 配置 想 要 监控 的 应 用 名 称 

# 2. 4clusterNameExpression: default 时 ，turbine.aggregator.clu 
sterConfig 可 以 不 写 ， 因 为 默认 就 是 default 

# 3. 4clusterNameExpression: metadata['cluster'] 时 ， 假 设想 要 监控 
的 应 用 配置 了 eureka.instance.metadata-map.cluster: ABC， 则 需要 配置 ， 同 
时 turbine.aggregator.clusterConfig: ABC 
eureka: 

client: 

serviceUrl: 
defaultZone: http://discovery:8/61/eureka/ 


### 4 :http://blog.csdn.net/liaokailin/article/details/51344281 


### 4 :http://blog.csdn.net/zhuchuangang/article/details/51289 
593 


Bp——————————————————X 2: mj 


这 样 一 个 Turbine 微 服务 就 编写 完成 了 9 


Turbine i] 试 


1. 启动 项 目 : microservice-discovery-eureka 
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启动 项 目 : microservice-provider-user 
3 动 项 目 : microservice-consumer-movie-ribbon-with-hystrix 
项 目 : microservice-consumer-movie-feign-with-hystrix-stream 


加 


项 目 : microservice-hystrix-dashboard 

> 动 项 目 : microservice-hystrix-turbine ( 即 本 例 ) 

. 访问 : http://localhost:8011/ribbon/1， 调 用 ribbon 接 口 

. 访问 : http://localhost:8022/feign/1， 调 用 feign 接 口 

. 访问 : http://localhost:8031/turbine.stream ， 可 查看 到 和 Hystrix 监 控 类 似 的 内 


OMNAAR WN 
w w 


容 : 


data: {"rollingCountFallbackSuccess":0,"rollingCountFallbackFail 
re":0, "propertyValue_circuitBreakerRequestVolumeThreshold":20," 


并 且 会 不 断 刷 新 以 获取 实时 的 监控 数据 。 同 样 的 ， 我 们 可 以 将 这 些 文本 内 容 放 入 到 
Dashboard 中 展示 。 


访问 Hystrix Dashboard : http://localhost:8030/hystrix.stream > # 
将 http://localhost:8031/turbine.stream 输 入 到 其 上 的 输入 框 ， 并 随意 指定 一 个 


Title > 4e FAI: 


Hystrix Dashboard 


http://loc alhost:8031/turbine.stream 


Cluster via Turbine (default cluster): http://turbine-hostname:port/turbine. stream 
Cluster via Turbine (custom cluster): http: //turbine-hostname:port/turbine. stream?cluster- 
[clusterName] 

Single Hystrix App: http://hystrix-app:port/hystrix. stream 





Delay: ms Title: iturbine-test ] 





| Monitor Stream 


将 会 查看 到 如 下 的 图 表 ， 有 图 可 见 ， 我 们 把 两 个 项 目的 API 都 监控 了 


Hystrix Stream: turbine-test 








Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 
findByldFeign findByld 
0; 0/0.C 0; 0/0.0 
0/0 0/0 
0 0 
0.0/s 0.0/s 
0.0/s 0.0/s 
Circuit Closed Circuit Closed 
Hosts 1 90th 0ms Hosts 1 90th 0ms 
Median 0ms 99th 0ms Median Oms 99th 0ms 
Mean Oms 99.5th 0ms Mean Oms 99.5th 0ms 
Thread Pools Sort: Alphabetical | Volume | 


microservice-provider-user RibbonHystrixService 

0.0/s 0.0/s 

0.0/s 0.0/s 

Active 0 Max Active 0 Active 0 Max Active 0 
Queued 0 Executions 0 Queued 0 Executions 0 
Pool Size 1 Queue Size 5 Pool Size 1 Queue Size 5 


TIPS 


1. "RH microservice-consumer-movie-ribbon-with-hystrix 和 


microservice-consumer-movie-feign-with-hystrix-stream 需要 配置 
不 同 的 主机 名 ， 并 将 preferlpAddress 设 为 false 或 者 不 设置 ， 否 则 将 会 造成 在 单 
个 主机 上 测试 ，Turbine 只 显示 一 个 图 表 的 情况 。 项 目的 代码 已 经 修改 好 并 注释 
了 ， 这 边 友 情 提示 一 下 。 


2. 配置 项 : turbine.clusterNameExpression 4 


turbine.aggregator.clusterConfig 的 关系 : 


turbine.clusterNameExpression 取 值 


默认 (appName) 


new String("default") 或 者 "default" 


metadata['cluster'] ; 同时 待 监控 的 项 目 
配置 了 类 似 : 
eureka.instance.metadata-map.cluster: 
ABC 


turbine.aggregator.clusterConfig 
取 值 


配置 想 要 聚合 的 项 目 ， 此 时 使 用 
turbine.stream?cluster= 项 目 名 称 大 
写 访 问 监控 数据 

不 配置 ， 或 者 配置 default， 因 为 默 
认 就 是 default 


也 设 成 ABC， 需 要 和 待 监控 的 项 目 
配置 的 eureka.instance.metadata- 
map.cluster— & > 


具体 可 以 关 

注 org.springframework.cloud.netflix.turbine.CommonsInstanceDiscover) 
和 org.springframework.cloud.netflix.turbine.EurekaInstanceDiscover) 
两 个 类 。 特 别 关注 一 

T org.springframework.cloud.netflix.turbine.EurekaInstanceDiscovery 
.marshall(InstanceInfo) 方法 。 


参考 文档 


http://blog.csdn.net/liaokailin/article/details/5 1344281 


http://stackoverflow.com/questions/3 146822 7/whats-for-the-spring-cloud- 
turbine-clusternameexpression-config-mean 


2.5 配置 中 心 


Spring Cloud Config 提 供 了 一 种 在 分 布 式 系统 中 外 部 化 配置 服务 器 和 客户 端的 支 
持 。 配 置 服务 器 有 一 个 中 心 位 置 ， 管 理 所 有 环境 下 的 应 用 的 外 部 属性 。 客 户 端 和 服 
务 器 映射 到 相同 Spring Eventment 和 PropertySrouce 抽 象 的 概念 ， 所 以 非常 适合 
Spring 应 用 ， 但 也 可 以 在 任何 语言 开发 的 任何 应 用 中 使 用 。 在 一 个 应 用 从 开发 、 
试 到 生产 的 过 程 中 ， 你 可 以 分 别 地 管理 开发 、 测 试 、 生 产 环境 的 配置 ， 并 且 在 迁 

的 时 候 获取 相应 的 配置 来 运行 。 


Config Server 存储 后 端 默认 使 用 git 存 储 配置 信息 ， 因 此 可 以 很 容易 支持 标记 配置 
环境 的 版 本 ， 同 时 可 以 使 用 一 个 使 用 广泛 的 工具 管理 配置 内 容 。 当 然 添 加 其 他 方式 
的 存储 实现 也 是 很 容易 的 。 


参考 : 
http://cloud.spring.io/spring-cloud-static/Brixton.SR5/#_spring_cloud_config 
核心 代码 : 


org.springframework.cloud.config.server.environment.NativeEnvir 


onmentRepository ， 留 意 其 中 的 findone 方法 。 
代码 示例 
准备 工作 


e 为 了 更 贴近 生产 ， 我 们 首先 配置 Host 


127.0.0.1 config-server 


e 准备 几 个 配置 文件 ， 命 名 规范 为 项 目 名 称 -环境 名 称 .properties ， 本 文 在 git 
仓库 : https://github.com/eacdy/spring-cloud-study/ 中 ， 新 建 目 录 config- 
repo * 创建 以 下 几 个 文件 : 


microservice-config-client-dev.properties 
microservice-config-client.properties 


其 中 在 : microservice-config-client-dev.properties 文件 中 添加 如 下 内 


全 


A. 


profile-dev 


ARAB 38 RAG zr 49] 
创建 一 个 Maven 项 目 ， 在 pom.xml 文 件 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xSi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-config-server</artifactId> 
<packaging>jar</packaging> 


<parent> 
<grouplId>com. itmuch.cloud</groupId> 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
<groupid>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-config-server</artifactId> 
</dependency> 
</dependencies> 
</project> 


Bak: 


2.5 配置 中 心 


/** 
* 通过 @EnableConfigServer 注 解 激活 配置 服务 . 

S DE: 

* 在 application.yml 中 有 个 git ,uri 的 配置 ， 目 前 配置 的 是 https://github.c 
om/eacdy/spring-cloud-study/ 

* 获取 git 上 的 资源 信息 遵循 如 下 规则 : 

* /{application}/{profile}[/{label}] 

> /{application}-{profile}.yml 

* /{label}/{application}-{profile}.yml 

* /{application}-{profile}.properties 

* /{label}/{application}-{profile}.properties 

* 

* 例如 本 例 : 可 使 用 以 下 路 径 来 访问 microservice-config-client-dev.prope 
rties: 

* http://localhost:8040/microservice-config-client-dev.properti 
es 

* http://localhost:8040/microservice-config-client/dev 

* 

* @author eacdy 

WA 
@SpringBootApplication 
@EnableConfigServer 

public class ConfigServerApplication { 

public static void main(String[] args) { 
SpringApplication.run(ConfigServerApplication.class, args); 


配置 文件 : application.yml 
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server: 
port: 8040 
spring: 
application: 
name: microservice-config-server 
cloud: 
config: 
server: 
git: 
uri: https://github.com/eacdy/spring-cloud-study/ 
# 配置 git 仓 库 的 地 址 
search-paths: config-repo 
# gjit 仓 库 地 址 下 的 相对 地 址 ， 可 以 配置 多 个 ， 用 ,分 割 。 
username: 
# gjit 仓 库 的 账号 
password: 


# git 仓 库 的 密码 
这 样 ， 一 个 Config Server 就 完成 了 。 
测试 工作 


获取 git 上 的 资源 信息 遵循 如 下 规则 

/{application}/{profile}[/{label}] 

/{application}-{profile}.yml 

/{label}/{application}-{profile}.yml 

/{application}-{profile}.properties 

/{label}/{application}-{profile}.properties 
例如 本 例 : 可 使 用 以 下 路 径 来 访问 microservice-config-client- 
dev.properties : http://localhost:8040/microservice-config-client-dev.properties 
http://localhost:8040/microservice-config-client/dev 


JE FR ES > RAT MABE T Config Server， 并 测试 能 够 正常 获取 到 git 仓 库 中 的 配置 
信息 。 那 么 对 于 一 个 微服 务 应 用 ， 如 何 才能 获取 配置 信息 呢 ? 


配置 服务 客户 端 示例 
新 建 一 个 Maven 项 目 ， 在 pom.xml 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xSsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-config-client</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId» 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactlId» 
«/dependency» 


«dependency» 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter -config</artifactId> 

</dependency> 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-actuator«/artifactId» 
</dependency> 
</dependencies> 
</project> 


编写 启动 类 : 


@SpringBootApplication 
public class ConfigClientApplication { 
public static void main(String[] args) ( 
SpringApplication.run(ConfigClientApplication.class, args); 
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/** 
* 这 边 的 @RefreshScope 注 解 不 能 少 ， 和 否则 即使 调用 /refresh， 配 置 也 不 会 刷新 
* @author eacdy 
E 

@RestController 

QRefreshScope 

public class ConfigClientController { 

@Value("S{profile}") 
private String profile; 


QGetMapping("/hello") 


public String hello() { 
return this.profile; 


配置 文件 : application.yml 


server: 
port: 8041 


配置 文件 bootstrap.yml〈 为 什么 要 使 用 bootstrap.yml 而 不 直接 放 在 
application.yml 中 的 原因 见 注意 点 ) 


spring: 
application: 
name: microservice-config-client # 对 应 microservice-config 
-Server 所 获取 的 配置 文件 的 {application} 
cloud: 
config: 
uri: http://config-server:8040/ 
profile: dev # 指定 profile， 对 应 microse 
rvice-config-server 所 获取 的 配置 文件 中 的 {profile} 
label: master # 指定 git 仓 库 的 分 支 ， 对 应 mi 
croservice-config-server 所 获取 的 配置 文件 的 {label} 


启动 ， 并 访问 : 
http://localhost:8041/hello ， 我 们 会 发 现 此 时 可 以 显示 git 仓 库 中 配置 文件 的 内 容 : 


dev 


配置 内 容 的 热 加 载 


如 果 不 重启 应 用 ， 能 够 做 到 配置 的 刷新 吗 ? 答案 显然 是 可 以 的 。 


我 们 将 microservice-config-client-dev.properties 中 值 改 为 


profile=abcd 


并 提交 到 git 仓 库 。 


后 使 用 命令 〈 本 文 使 用 的 是 curl，Linux 和 Windows 都 有 curl 工 具 ， 当 然 也 可 以 借 
助 其 他 工具 ， 例 如 Postman 等 ) 


curl -X POST http://localhost:8041/refresh 


然后 再 次 访问 http:Wlocalhost:8041/hello ， 将 会 看 到 : abcd ， 说 明 配 置 已 经 刷 
新 。 


忆 置 服务 与 注册 中 心 联合 使 用 


在 生产 环境 中 ， 我 们 可 能 会 将 Config Server 与 Eureka 等 注册 中 心 联合 使 用 ( 注 
Š : 目前 Spring Cloud 只 支持 与 Eureka 及 Consul 联 合 使 用 ， 不 支持 与 Zookeeper 联 
合 使 用 ) ， 下 面 讲解 如 何 将 Config Server 与 Eureka 联合 使 用 。 


准备 工作 


1. 启动 服务 microservice-discovery-eureka ; 
2. 和 上 文 一 样 ， 准 备 好 几 个 配置 文件 ， 命 名 规范 为 项 目 名 称 -环境 名 
#k.properties ， 本 文 使 用 的 名 称 是 microservice-config-client- 


eureka-dev.properties ° 


代码 示例 


服务 器 端 代码 示例 : 


首先 新 建 一 个 Maven 项 目 ， 在 pom.xml 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-config-server -eureka</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId» 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-config-server</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter -eureka</artifactId> 
</dependency> 
</dependencies> 
</project> 


启动 类 : ConfigServerEurekaApplication. java 


@SpringBootApplication 
@EnableConfigServer 
@EnableDiscoveryClient 
public class ConfigServerEurekaApplication { 
public static void main(String] args) { 
SpringApplication.run(ConfigServerEurekaApplication.class, 
rgs); 
j 


配置 文件 : application.yml 


server: 
port: 8050 
spring: 
application: 
name: microservice-config-server-eureka 
cloud: 
config: 
server: 
git: 
uri: https://github.com/eacdy/spring-cloud-study/ 
search-paths: config-repo 
username: 
password: 
eureka: 
client: 
serviceUrl: 
defaultZone: http://discovery:8/61/eureka/ 
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创建 一 个 Maven 项 目 ， 在 pom.xml 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-config-client -eureka</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId» 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactlId» 

«/dependency» 

«dependency» 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter -config</artifactId> 

</dependency> 

<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter -eureka</artifactId> 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-actuator«/artifactId» 

«/dependency» 

«/dependencies» 
</project> 


启动 类 : ConfigClientEurekaApplication. java 


@SpringBootApplication 
@EnableDiscoveryClient 
public class ConfigClientEurekaApplication { 
public static void main(String[] args) { 
SpringApplication.run(ConfigClientEurekaApplication.class, a 
rgs); 
} 


编写 测试 Controller 


/** 
* 这 边 的 @RefreshScope 注 解 不 能 少 ， 否 则 即使 调用 /refresh， 配 置 也 不 会 刷新 
* @author eacdy 
WA 

@RestController 

@Ref reshScope 

public class ConfigClientController { 

@Value("S{profile}") 
private String profile; 


QGetMapping("/hello") 


public String hello() { 
return this.profile; 


配置 文件 : application.yml 


server: 
port: 8051 


配置 文件 : bootstrap.yml 


spring: 
application: 
name: microservice-config-client-eureka 
cloud: 
config: 
profile: dev 
label: master 
discovery: 
enabled: true 默认 false 
， 设 为 true 表 示 使 用 注册 中 心中 的 configserver 配 置 而 不 自己 ot 
的 Uri 
serviceId: microservice-config-server-eureka # 指定 confi 
g Server 在 服务 发 现 中 的 sServiceId， 默认 为 : configserver 
eureka: 
client: 
serviceUrl: 
defaultZone: http://discovery:8/61/eureka/ 


# 参考 文档 : https://github.com/spring-cloud/spring-cloud-config/bl 
ob/master/docs/src/main/asciidoc/spring-cloud-config.adoc#discov 
ery-first-bootstrap 


从 示例 代码 我 们 发 现 ， 想 要 将 Config Server 5 注册 中 心 联 合 使 用 ， 只 需要 在 客户 
端 侧 配 置 spring.cloud.config.discovery.enabled-true 和 
spring.cloud.config.discovery.serviceId 两 个 配置 项 即 可 。Eureka 的 配置 
前 文 有 讲 到 过 ， 如 有 疑问 ， 详 见 服务 发 现 的 相关 章节 。 


注意 : 当 服 务 发 现 是 Eureka 及 Consul 时 ，Config Server 支 持 与 之 联合 使 
用 ; 如 果 是 Zookeeper 做 服务 发 现 ， 目 前 不 支持 与 之 联合 使 用 。 
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e client 需 要 添加 以 下 依赖 ， 否 则 访问 /refresh 将 会 得 到 404 : 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-actuator</artifactIid> 
</dependency> 


e client 的 controller 需 要 添加 @RefreshScope 注 解 ， 否 则 配置 无 法 刷新 。 

e 本 文 的 bootstrap.yml 文件 中 的 内 容 不 能 放 到 application.yml 中 ， 否 则 
config 部 分 无 法 被 加 载 ， 因 为 config 部 分 的 配置 先 于 application.yml 被 加 
载 ， 而 bootstrap.yml 中 的 配置 会 先 于 application.yml 加 载 ， 

e Config Server 也 可 以 支持 本 地 存储 或 svn 而 不 使 用 git， 相 对 较为 简单 ， 故 而 本 
文 不 作 坎 述 ， 有 兴趣 的 可 以 自行 阅读 Spring Cloud 的 文档 。 


参考 文档 : 


Config Server 与 注册 中 心 联合 使 用 : https://github.com/spring-cloud/spring- 
cloud-config/blob/master/docs/src/main/asciidoc/spring-cloud- 
config.adoc#discovery-first-bootstrap 


Config Server 的 高 可 用 : https://github.com/spring-cloud/spring-cloud- 
config/issues/87 


2.6 API Gateway 
API Gateway 是 微服 务 架 构 中 不 可 或 缺 的 部 分 。API Gateway 的 定义 以 及 存在 的 意 
义 ，Chris 已 经 为 大 家 描述 过 了 ， 本 文 不 再 赖 述 ， 以 下 是 链接 : 

中 文 版 : http://dockone.io/article/482 


美文 版 : https://www.nginx.com/blog/building-microservices-using-an-api- 
gateway/ 


使 用 API Gateway 后 ， 客 户 端 和 微服 务 之 间 的 网 络 图 变 成 下 图 : 
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i8 x API Gateway， 可 以 统一 向 外 部 系统 提供 REST API » Spring Cloud ¥ 4% Ff] Zuul 
作为 API Gateway。Zuul 提 供 了 动态 路 由 、 监 控 、 回 退 、 安 全 等 功能 。 





下 面 我 们 进入 Zuul 的 学 习 : 


准备 工作 


e 为 了 更 贴近 生产 ， 我 们 首先 配置 Host 


127.0.0.1 gateway 


e 启动 服务 : microservice-discovery-eureka 
e 局 动 服务 : microservice-provider-user 


Zuul 代 码 示 例 


创建 Maven 项 目 ， 在 pom.xml 中 添加 如 下 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"ht 

tp://www.w3.org/2001/XMLSchema-instance" 
xSi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://m 

aven.apache.org/xsd/maven-4.0.0.xsd"> 


<modelVersion>4.0.0</modelVersion> 


<artifactId>microservice-api-gateway</artifactId> 
<packaging>jar</packaging> 


<parent> 
«groupId»com.itmuch.cloud«c/groupId» 
<artifactId>spring-cloud-microservice-study</artifactId> 
<version>0.0.1-SNAPSHOT</version> 

</parent> 


<dependencies> 
<dependency> 
<grouplId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter -zuul</artifactId> 
</dependency> 


<dependency> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter -eureka</artifactId> 
</dependency> 
</dependencies> 
</project> 


启动 类 : 


/** 
* 4% M @EnableZuulProxy zx zuul ° 
* 跟 进 该 注解 可 以 看 到 该 注解 整合 了 @EnableCircuitBreaker 、@EnableDiscov 
eryClient， 是 个 组 合 注 解 ， 目 的 是 简化 配置 。 
* @author eacdy 
iy 
QSpringBootApplication 
QEnablezuulProxy 
public class ZuulApiGatewayApplication { 
public static void maxzn(String[] args) 4 
SpringApplication.run(ZuulApiGatewayApplication.class, args) 


配置 文件 : application.yml 


Spring: 
application: 
name: microservice-api-gateway 


server: 
port: 8050 

eureka: 
instance: 


hostname: gateway 
client: 
serviceUrl: 
defaultZone: http://discovery:8/61/eureka/ 


这 样 ， 一 个 简单 的 API Gateway 就 完成 了 。 
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启动 microservice-api-gateway 项 目 。 还 记得 我 们 之 前 访问 通过 
http://localhost:8000/1 去 访问 microservice-provider-user 服 务 中 id=1 的 用 户 信息 
吗 ? 


我 们 现在 访问 http://localhost:8050/microservice-provider-user/1 试 试 。 会 惊人 地 看 
到 : 


{"id":1, "username" :"Tom", sagen: 127 


这 不 正 是 microservice-provider-user 服 务 中 id=1 的 用 户 信 息 吗 ? 


所 以 我 们 可 以 总 结 出 规律 : 访问 
http://GATEWAY:GATEWAY_PORT/ 想 要 访问 的 EUreka 服 务 id 的 小 写 /** 
， 将 会 访问 到 


http:// 想 要 访问 的 Eureka 服 务 id 的 小 写 : 该 服务 端口 /** 
> ` A 
目 定 义 路 径 
上 文 我 们 已 经 完成 了 通过 API Gateway 去 访问 微服 务 的 目的 ， 是 通过 
http://GATEWAY:GATEWAY_PORT/ 想 要 访问 的 Eureka 服 务 id 的 小 写 /** 


的 形式 访问 的 ， 那 么 如 果 我 们 想 自 定义 在 API Gateway 中 的 路 径 呢 ? 壁 如 想 使 用 


http://localhost:8050/user/1 
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只 需要 做 一 点 小 小 的 配置 即 可 : 


spring: 
application: 
name: microservice-api-gateway 
server: 
port: 8050 
eureka: 
instance: 
hostname: gateway 
client: 
serviceUrl: 
defaultZone: http://discovery:8/61/eureka/ 
# 下 面 整 个 树 都 非 必 须 ， 如 果 不 配置 ， 将 默认 使 用 http://GATEWAY :GATEWAY_POR 
T/ 想 要 访问 的 Eureka 服 务 id 的 小 写 /** 路 由 到 : http:// 想 要 访问 的 Eureka 服 务 id 
的 小 写 :该 服务 端口 /xx 
zuul: 
routes: 
user: # 可 以 随 
便 写 ， 在 ZUU1L 上 面 唯一 即 可 ; 当 这 里 的 值 = service-id 时 ，service-id 可 以 不 写 。 


path: /user/** # 想 要 映 
射 到 的 路 径 
service-id: microservice-provider-user # Eureka 


中 的 serviceId 


图 





如 1 何 忽略 某 些 服务 


1. 启动 服务 : microservice-discovery-eureka 
2. 启动 服务 : microservice-provider-user 
3. 启动 服务 : microservice-consumer-movie-ribbon 


如 果 我 们 现在 只 想 将 microservice-consumer-movie-ribbon 服 务 暴 圳 给 外 部 ， 
microservice-provider-user 不 想 暴 露 ， 那 么 应 该 怎么 办 呢 ? 


依然 只 是 一 点 小 小 的 配置 即 可 : 


spring: 
application: 
name: microservice-api-gateway 


server: 
port: 8050 

eureka: 
instance: 


hostname: gateway 
client: 
serviceUrl: 
defaultZone: http://discovery:8/61/eureka/ 


zuul: 
ignored-services: microservice-provider-user How x 
视 的 服务 (配置 后 将 不 会 被 路 由 ) 
routes : 
movie: # 可 以 随 


便 写 ， 在 ZUUL 上 面 唯一 即 可 ; 当 这 里 的 值 = service-idH * service-id T AR 5e 


path: /movie/** # 想 要 映 
射 到 的 路 径 
service-id: microservice-consumer-movie-ribbon-with-hystri 


x # Eureka 中 的 serviceId 


E 





3x ## microservice-provider-user/k 4 3t T Aik% H > microservice-consumer- 
movie-ribbon 服 务 则 会 被 路 由 。 


测试 结果 : 
URL 结果 
说 日 
http://localhost:8050/microservice- 404 mic 
provider-user/1 pro 
RH 
说 日 
mic 
http://localhost:8050/movie/ribbon/1 | (l"id":1,"username";"Tom","age":12) con 
mo' 


使 用 Zuul 不 使 用 Eureka 


Zuul 并 不 依赖 Eureka， 可 以 脱离 Eureka 运 行 ， 此 时 需要 配置 


Spring: 
application: 
name: microservice-api-gateway 
server: 
port: 8050 
zuul: 
routes: 
movie: # TUM 


path: /user/** 
url: http://localhost:8000/ # path 


由 到 的 地 址 ， 也 就 是 访问 http://localhost:8050/user/** 会 路 由 到 http://loc 
alhost:8000/** 


我 们 可 尝试 访问 http://localhost:8050/user/1 ， pidan 
http:Wlocalhost:8000/1。 不 过 在 大 多 数 情况 下 ， 笔 者 并 不 建 么 做 ， 因 为 得 手动 
大 量 地 配置 URL， 不 是 很 方便 。 


其 他 使 用 
Zuul 还 支持 更 多 的 特性 、 更 多 的 配置 项 甚至 是 定制 开发 ， 具 体 还 请 读者 自行 发 气 。 
同类 软件 


Zuul 只 是 API Gateway 的 一 种 实现 ， 可 作为 API Gateway 的 软件 有 很 多 ， 璧 如 Nginx 
Plus ` Kong > AX AULT © 


参考 文档 


https://www.nginx.com/blog/building-microservices-using-an-api-gateway/ 
http://microservices.io/patterns/apigateway.html 


2.6 API Gateway 
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3 使 用 Docker 构 建 微 服务 


准备 工作 


安装 软件 版 本 


Docker 1.12.1 


CentOS7.0 
或 其 他 系 7.0 
统 , 


Maven 3.3.9 
JDK 8u65 
注意 : 


Docker 


Docker 的 宿主 机 ， 本 章 的 讲解 都 是 在 CentOS 7.0 
下 进行 的 。Docker 现 已 支持 Windows 系 统 ， 但 考 
虑 到 绝 大 多 数 Docker 容 器 还 是 跑 在 Linux 环 境 下 
的 ， 故 而 只 讲解 Linux 环 境 下 的 使 用 。Windows 下 
的 安装 使 用 大 臻 类似， 请 读者 自行 研究 。 


本 章 的 讲解 都 是 在 CentOS7 下 进行 的 ， 建 议 新 手 使 用 CentOS 7.x 进 入 学 习 。 


CentOS T JDK 1.8 的 安装 


(1) 到 Oracle 官 网 下 载 好 jdk-8u65-linux-x64.rpm 备用 


(2) 卸载 系统 自 带 java 


java -version 
rpm -qalgrep java 


# 如 果 有 结果 出 来 ， 则 说 明 自 带 了 java 
# 查询 出 已 经 安装 的 java 


yum -y remove [上 面 查 出 来 的 东西 ， 多 个 用 空格 分 隔 ] 


(3) 安装 JDK 


hs 


yaku 


cd /usr 
mkdir /usr/java 
rpm -ivh jdk-8u65-linux-x64.rpm 


(4) 配置 环境 变量 : 


vim /etc/profile 


找到 : export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL 
这 一 行 ， 并 在 其 下 面 一 行 添加 如 下 内 容 : 

# 设置 java 环 境 变量 

export JAVA_HOME=/usr/java/jdk1.8.0_65 # 根据 情况 修改 

export PATH=$JAVA_HOME/bin:$PATH 


export CLASSPATH=. :$JAVA_HOME/1ib/dt.jar:$JAVA_HOME/1ib/tools.ja 
r 


(5) 使 环境 变量 生效 : 
source /etc/profile 
(6) 测试 : 


java -version 
javac 


CentOS T Maven#y € € 


Maven 的 安装 比较 简单 ， 只 需要 下 载 后 解压 ， 配 置 环 境 变量 即 可 。 


(1) 下 载 并 解压 : 


cd /opt 

wget http://apache.fayea.com/maven/maven-3/3.3.9/binaries/apache 
-maven-3.3.9-bin. tar.gz 

tar -zxvf apache-maven-3.3.9-bin.tar.gz 


(2) 配置 环境 变量 : 


vim /etc/profile 


找到 export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL  ， 
并 在 其 下 面 一 行 添加 如 下 内 容 : 


# 设置 Maven 环 境 变量 
export MAVEN_HOME=/opt/apache-maven-3.3.9/ 
export PATH=$MAVEN_HOME/bin: $PATH 


(3) 使 环境 变量 生效 : 
source /etc/profile 
(4) 测试 


mvn -version 


(5) 修改 Maven 配 置 


本 地 仓库 路 径 配 置 : 


«i 


<localRepository>/path/to/local/repo</localRepository> 


国内 Maven 镜 像 配置 : 


<mirror> 
<id>aliyun</id> 
<mirrorOf>central</mirrorof> 
<name>Aliyun Central mirror</name> 
<url>http://maven.aliyun.com/nexus/content/groups/public</ur1> 
</mirror> 


CentOS T Git£ X 


yum install git 


3.1 Docker^ Zi 


Docker 5i, 


Docker 是 一 个 用 于 开发 、 交 付 和 运行 应 用 的 开放 平台 ，Docker 被 设计 用 于 更 快 地 交 
付 应 用 。Docker 可 以 将 应 用 程序 和 基础 设施 层 隔 离 ， 并 且 可 以 将 基础 设施 当 作 程序 
一 样 进行 管理 。 使 用 Docker， 可 以 更 快 地 打包 代码 、 测 试 以 及 部 署 ， 并 且 可 以 减少 
从 编写 到 部 署 运行 代码 的 周期 。 


Docker 将 内 核 容 器 特性 (LXC) 、 工 作 流 和 工具 集成 ， 以 帮助 管理 和 部 署 应 用 。 


什么 是 Docker 


核心 是 ，Docker 了 一 种 在 安全 隔离 的 容器 中 运行 近乎 所 有 应 用 的 方式 ， 这 种 隔离 性 
和 安全 性 允许 你 在 同一 个 主机 上 同时 运行 多 个 容器 ， 而 容器 的 这 种 轻 量 级 特性 ， 无 
需 消 耗 运行 hpervisor 所 需 的 额外 人 负载， 意味 着 你 可 以 节省 更 多 的 硬件 资源 。 


基于 容器 虚拟 化 的 工具 或 平台 可 提供 : 


将 应 用 (包括 支撑 组 件 ) 放 入 Docker 容 器 中 
e 分 发 和 交付 这 些 容 器 给 团队 ， 便 于 后 续 的 开发 和 测试 
e 将 容器 部 署 到 生产 环境 中 ， 生 产 环境 可 以 是 本 地 的 数据 中 心 ， 也 可 以 在 云端 。 


自从 上 世纪 90 WA seca toe N ， 对 数据 中 心 而 言 ， 发 
生 的 最 大 的 变革 英 过 器 和 容器 管理 工具 ， 例 如 : Docker。 在 过 去 的 一 年 内 ， 
Docker 技术 已 经 逐 并 且 推动 了 大 型 初创 公司 例如 Twitter 和 Airbnb 的 
发 展 ， 甚 至 在 银行 、 连 锁 超 市 、 甚 至 NASA 的 数据 中 心 都 赢得 了 一 席 之 地 。 当 我 几 
年 前 第 一 次 直到 Docker 的 时 候 ， 我 还 对 Docker 的 未 来 持 怀 疑 的 态度 ， 我 认为 他 
们 是 把 以 前 的 Linux 容器 的 概念 拿 出 来 包装 了 一 番 推 向 市 场 。 但 是 使 用 Docker 成 
功 进 行 了 几 个 项 目 例如 Spantree 之 后 ， 我 改变 了 我 的 看 法 : Docker 帮助 我 们 节省 
了 大 量 的 时 间 和 经 历 ， 并 且 已 经 成 为 我 们 技术 团队 中 不 可 或 缺 的 工具 。 GitHub 上 
面 每 天 都 会 催生 出 各 式 各 样 的 工具 、 形 态 各 异 的 语言 和 千奇百怪 的 概念 。 如 果 你 和 
AH RNAI RAIMA EUH RAR MEA Doeker， 
那么 你 可 以 看 一 下 我 的 这 篇 文章 : 我 们 在 Docker 中 总 结 的 经 验 来 告诉 你 
什么 是 Docker、 为 什么 Docker 会 这 么 火 。 


Docker 是 容器 管理 工具 Docker 是 一 个 轻 量 级 、 便 携 式 、 与 外 界 隔 离 的 容器 ， 也 是 
一 个 可 以 在 容器 中 很 方便 地 构建 、 传 输 、 运 行 应 用 的 引擎 。 和 传统 的 虚拟 化 技术 不 
同 的 是 ，Docker 引擎 并 不 虚拟 出 一 全 虚拟 机 ， 而 是 直接 使 用 宿主 机 的 内 核 和 硬 
件 ， 直 接 在 宿主 机 上 运行 容器 内 应 用 。 也 正 是 得 益 于 此 ，Docker 容器 内 运行 的 应 
用 和 宿主 机 上 运行 的 应 用 性 能 差距 几乎 可 以 忽略 不 计 。 但 是 Docker 本 身 并 不 是 一 
个 容器 系统 ， 而 是 一 个 基于 原 有 的 容器 化 工具 LXC 用 来 创建 虚拟 环境 的 工具 。 类 
似 LXC 的 工具 已 经 在 生产 环境 中 使 用 多 年 ，Docker 则 基于 此 提供 了 更 加 友好 的 镜 
像 管理 工具 和 部 署 工具 。 


Docker 不 是 虚拟 化 引擎 Docker 第 一 次 发 布 的 时 候 ， 很 多 人 都 拿 Docker 和 虚拟 机 
VMware ` KVM 和 VirtualBox 比较 。 尽 管 从 功能 上 看 ，Docker 和 虚拟 化 技术 致力 
于 解决 的 问题 都 差不多 ， 但 是 Docker 却 是 采取 了 另 一 种 非常 不 同 的 方式 。 虚 拟 机 
是 虚拟 出 一 套 硬件 ， 虚 拟 机 的 系统 进行 的 磁盘 操作 ， 其 实 都 是 在 对 虚拟 出 来 的 磁盘 
进行 操作 。 当 运行 CPU 密集 型 的 任务 时 ， 是 虚拟 机 把 虚拟 系统 里 的 CPU 指令 “ 翻 
译 " 成 宿主 机 的 CPU 指 令 并 进行 执行 。 两 个 磁盘 层 ， 两 个 处 理 器 调度 器 ， 两 个 操作 
系统 消耗 的 内 存 ， 所 有 虚拟 出 的 这 些 都 会 带 来 相当 多 的 性 能 损失 ， 一 台 虚 拟 机 所 消 
耗 的 硬件 资源 和 对 应 的 硬件 相当 ， 一 侣 主机 上 跑 太 多 的 虚拟 机 之 后 就 会 过 载 。 而 
Docker 就 没有 这 种 顾虑 。Docker 运行 应 用 采取 的 是 “容器 ”的 解决 方案 : 使 用 
namespace 和 CGroup 进行 资源 限制 ， 和 宿 wa ， 不 虚拟 磁盘 ， 所 有 的 
容器 磁盘 操作 其 实 都 是 对 /var/lib/docker/ 的 操作 。 简 言 之 ，Docker HERR LH d 
主机 中 运行 了 一 个 受到 限制 的 应 用 程序 。 从 上 面 不 难看 出 ， 容 器 和 虚拟 机 的 概念 并 
不 相同 ， 容 器 也 并 不 能 取代 庶 拟 机 。 在 容器 力 所 不 能 及 的 地 方 ， 虚 拟 机 可 以 大 显 身 
手 。 例 如 : 宿主 机 是 Linux， 只 能 通过 虚拟 机 运行 Windows > Docker 便 无 法 做 

到 。 再 例如 ， 宿 主机 是 Windows > Windows 并 不 能 直接 运行 Docker ，Windows 上 
的 Docker 其 实 是 运行 在 VirtualBox 虚拟 机 里 的 。 


Docker 使 用 层级 的 文件 系统 前 面 提 到 过 ，Docker 和 现 有 容器 技术 LXC 等 相 比 ， 
优势 之 一 就 是 Docker 提供 了 镜像 管理 。 对 于 Docker 而 言 ， 镜 像 是 一 个 静态 的 、 
只 读 的 容器 文件 系统 的 快照 。 然 而 不 仅 如 此 ，Docker 中 所 有 的 磁盘 操作 都 是 对 特 
定 的 Copy-On-Write 文 件 系统 进行 的 。 下 面 通 过 一 个 例子 解释 一 下 这 个 问题 。 例 如 
我 们 要 建立 一 个 容器 运行 JAVA Web 应 用 ， 那 么 我 们 应 该 使 用 一 个 已 经 安装 了 
JAVA 的 镜像 。 在 Dockerfile (一 个 用 于 生成 镜像 的 指令 文件 ) 中 ， 应 该 指明 "基于 
JAVA 镜像 *， 这样 Docker 就 会 去 Docker Hub Registry 上 下 载 提前 构建 好 的 JAVA 
镜像 。 然 后 再 Dockerfile 中 指明 下 载 并 解压 Apache Tomcat 软件 到 /opt/tomcat X 
件 夹 中 。 这 条 命令 并 不 会 对 原 有 的 JAVA 镜像 产生 任何 影响 ， 而 仅仅 是 在 原 iis 
上 面 添加 了 一 个 改动 层 。 当 一 个 容器 启动 时 ， 容 器 内 的 所 有 改动 层 都 会 启动 ， 
会 从 第 一 层 中 运行 /usr/bin/java 命令 ， 并 且 调 用 另外 一 层 中 的 ie op 


4 » £ERE » Dockerfile 中 每 一 条 指令 都 会 产生 一 个 新 的 改动 层 ， 即 便 只 有 一 个 文 
件 被 改动 。 如 果 用 过 Git 就 能 更 清楚 地 认识 这 一 点 ， 每 条 指令 就 像 是 每 次 commit? 
都 会 留 下 记录 。 但 是 对 于 Docker 来 说 ， 这 种 文件 系统 提供 了 更 大 的 灵活 性 ， 也 可 
以 更 方便 地 管理 应 用 程序 。 我 们 Spantree 的 团队 有 一 个 自己 维护 的 含有 Tomcat 的 
镜像 。 发 布 新 版 本 也 非常 简单 : 使 用 Dockerfile 将 新 版 本 拷贝 进 镜像 从 而 创建 一 
新 镜像 ， 然 后 给 新 镜像 贴 上 版 本 的 标签 。 不 同 版 本 的 镜像 的 不 同 之 处 仅仅 是 一 个 90 
MB 大 小 的 WAR 文件 ， 他 们 所 基于 的 主 镜像 都 是 相同 的 。 如 果 使 用 虚拟 机 去 维护 
这 些 不 同 的 版 本 的 话 ， 还 要 消耗 掉 很 多 不 同 的 磁盘 去 存储 相同 的 系统 ， 而 使 用 
Docker 就 只 需要 很 小 的 磁盘 空间 。 即 便 我 们 同时 运行 这 个 镜像 的 很 多 实例 ， 我 们 
也 只 需要 一 个 基础 的 JAVA | TOMCAT 镜像 。 


Docker 可 以 节约 时 间 很 多 年 前 我 在 为 一 个 连锁 餐厅 开发 软件 时 ， 仅 仅 是 为 了 描述 
如 何 搭建 环境 都 需要 写 一 个 12 页 的 Word 文档 。 例 如 本 地 Oracle 数据 库 ， 特 定 版 
本 的 JAVA， 以 及 其 他 七 七 八 八 的 系统 工具 和 共享 库 、 软 件 包 。 整 个 搭建 过 程 浪 费 
掉 了 我 们 团队 每 个 人 几乎 一 天 的 时 间 ， 如 果 用 金钱 衡量 的 话 ， 花 掉 了 我 们 上 万 美金 
的 时 间 成 本 。 虽 然 客户 已 经 对 这 种 事情 习以为常 ， 甚 至 认为 这 是 引入 新 成 员 、 让 成 
员 适 应 环境 、 让 自己 的 员工 适应 我 们 的 软件 所 必须 的 成 本 ， 但 是 相 比 较 起 来 ， 我 们 
宁愿 把 更 多 的 时 间 花 在 为 客户 构建 可 以 增进 业务 的 功能 上 面 。 如 果 当 时 有 
Docker， 那 么 构建 环境 就 会 像 使 用 自动 化 搭建 工具 Puppet / Chef / Salt / Ansible 
一 样 简单 ， 我 们 也 可 以 把 整个 搭建 时 间 周 期 从 一 天 缩短 为 几 分 钟 。 但 是 和 这 些 工具 
不 同 的 地 方 在 于 ，Docker 可 以 不 仅仅 可 以 搭建 整个 环境 ， 还 可 以 将 整个 环境 保存 
成 磁盘 文件 ， 然 后 复制 到 别 的 地 方 。 需 要 从 源码 编译 Node.js 吗 ? Docker 做 得 到 。 
Docker 不 仅仅 可 以 构建 一 个 Node.js 环境 ， 还 可 以 将 整个 环境 做 成 镜像 ， 然 后 保存 
到 任何 地 方 。 当 然 ， 由 于 Docker 是 一 个 容器 ， 所 以 不 用 担心 容器 内 执行 的 东西 会 
对 宿主 机 产生 任何 的 影响 。 现在 "e 团队 的 人 只 需要 运行 docker-compose 
up 命令 ， 便 可 以 喝 杯 咖啡 ， 然 后 开始 工作 了 。 


Docker 可 以 节省 开销 当然 ， 时 间 就 是 金钱 。 除 了 时 间 外 ，Docker 还 可 以 节省 在 基 
础 设施 硬件 上 的 开销 。 高 德 纳 和 麦肯锡 的 研究 表明 ， 数 据 中 心 的 利用 率 在 6% - 
12% 左右 。 不 仅 如 此 ， 如 果 采 用 虚拟 机 的 话 ， 你 还 需要 被 动 地 监控 和 设置 每 台 虚 拟 
机 的 CPU 硬盘 和 内 存 的 使 用 率 ， 因 为 采用 了 静态 分 区 (static partitioning) 所 以 资源 
并 不 能 完全 被 利用 。。 而 容器 可 以 解决 这 个 问题 : 容器 可 以 在 实例 之 间 进 行内 存 和 
磁盘 共享 。 你 可 以 在 同一 台 主 机 上 运行 多 个 服务 、 可 以 不 用 去 限制 容器 所 消耗 的 资 
: 、 可 以 去 限制 资源 、 可 以 在 不 需要 的 时 候 停止 容器 ， 也 不 用 担心 启动 已 经 停止 的 
程序 时 会 带 来 过 多 的 资源 消耗 。 凌 展 三 点 的 时 候 只 有 很 少 的 人 会 去 访问 你 的 网 站 ， 
同时 你 需要 比较 多 的 资源 执行 夜间 的 批 处 理 任务 ， 那 么 可 以 很 简单 的 便 实 现 资源 的 
交换 。 ME PPL FEN AG AR. CPU 都 是 固定 的 ， 一 般 动 态 调整 都 需要 重 局 
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虚拟 机 。 而 用 Docker 的 话 ， 你 可 以 进行 资源 限制 ， 得 益 于 CGroup， 可 以 很 方便 
动态 调整 资源 限制 ， 让 然 也 可 以 不 进行 资源 限制 。Docker 容器 内 的 应 用 对 宿主 机 
而 言 只 是 两 个 隔离 的 应 用 程序 ， 并 不 是 两 个 虚拟 机 ， 所 以 宿主 机 也 可 以 自行 去 分 配 


注 : 
部 分 翻译 自 : https://docs.docker.com/engine/understanding-docker/ 


部 分 参考 : http://zhidao.baidu.com/link? 
url=4FOwNhnpVC3FPOhOxaC4vrl3fF G27IWRpDEaZ3KJBVLOE29C50- 
ty4zqze1On52Uk4kcNrnPa3VEKpKvRs4pNEV-Igo78lmP1 FXffMerdG 


参考 文档 

Docker 介 绍 : http://www.lupaworld.com/article-243555-1.html 

Docker 介 绍 : http://www.docker.org.cn/book/docker/what-is-docker-16.html 
Docker 官 方 文档 : https://docs.docker.com/engine/understanding-docker/ 
Docker 中 文 文档 : http://git.oschina.net/widuu/chinese_docker 


Docker 介 绍 : https://segmentfault.com/a/1190000002609286 
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3.2 Docker 的 安装 


Docker 的 安装 是 比较 简单 的 ， 笔 者 原本 不 想 过 多 提 及 ; 但 是 看 到 有 不 少 读者 对 
Docker 的 安装 提出 了 疑问 ， 故 此 进行 一 个 安装 的 总 结 。 


对 于 Linux 用 户 可 以 借助 其 发 行 版 的 Linux 包 管理 工具 安装 ， 对 于 Windows 和 MAC 用 
户 相 对 麻烦 一 些 ， 笔 者 下 面 以 Windows7 系 统 为 例 ， 讲 述 安 装 过 程 。 笔 者 强烈 建议 
大 家 使 用 Linux 系 统 进 入 本 章 的 学 习 ， 第 一 是 比较 符合 目前 Docker 的 市 场 趋势 ， 第 
二 Docker 本 身 就 是 基于 Linux 的 LXC 技 术 。 


CentOS 7.0 下 Docker 的 安装 


1. 查看 内 核 版 本 (Docker 需 要 64 位 版 本 ， 同 时 内 核 版 本 在 3.10 以 上 ， 如 果 版 本 低 
于 3.10， 需 要 升级 内 核 ) : 


uname -r 


2. 更 新 yum 包 : 


yum update 


3. 添加 yum 仓 库 : 


sudo tee /etc/yum.repos.d/docker.repo ««-'EOF' 
[dockerrepo] 

name-Docker Repository 
baseurl-https://yum.dockerproject.org/repo/main/centos/7/ 
enabled-1 

gpgcheck=1 

gpgkey=https://yum.dockerproject.org/gpg 

EOF 


yum install docker-engine 


5. Æ Docker 


service docker start 


6. 使 用 Docker 国 内 镜像 (为 Docker 镜 像 下 载 提速 ， 非 必须 ) 


curl -sSL https://get.daocloud.io/daotools/set_mirror.sh | s 
h -s http://fe8a7d6e.m.daocloud.io 


B: 


官方 文档 : https://docs.docker.com/engine/installation/linux/centos/ 


CentOS 6.5 下 Docker 的 安装 


Docker 容 器 最 早 受 到 RHEL 完 善 的 支持 是 从 最 近 的 CentOS 7.0 开 始 的 ， 官 方 说 明 是 
只 能 运行 于 64 位 架构 平台 ， 内 核 版 本 为 2.6.32-431 及 以 上 (BP >= CentOS 6.5， 运 
行 docker 时 实际 提示 3.10.0 及 以 上 ) 。 需要 注意 的 是 CentOS 6.5 与 7.0 的 安装 是 有 
一 点 点 不 同 的 ，CentOS 6.Xx 上 Docker 的 安装 包 叫 docker-io， 并 且 来 源 于 Fedora 
epel 库 ， 这 个 仓库 维护 了 大 量 的 没有 包含 在 发 行 版 中 的 软件 ， 所 以 先 要 安装 

EPEL ， 而 CentOS 7.x 的 Docker 直 接 包含 在 官方 镜像 源 的 Extras 人 仓库 ( CentOS- 
Base.repo 下 的 [extras] 节 enable=1 启 用 ) 。 

下 面 就 CentOS 6.5 讲 解 Docker 的 安装 过 程 ， 以 下 是 软件 版 本 : 


Linux 版 本 Docker 版 本 
CentOS 6.5 X64 (只 能 X64 ) 1.7.1 


升级 内 核 


查看 内 核 版 本 : 


uname -r 


结果 : 2.6.32-431.e16.x86 64 ， 不 满足 上 文 的 需求 ， 故 此 需要 升级 内 核 。 
升级 步骤 : 


1. 导入 公 铀 数字 证 书 


rpm --import https://www.elrepo.org/RPM-GPG-KEY-elrepo.org 


2. 安装 ELRepo 


rpm -ivh http://www.elrepo.org/elrepo-release-6-5.e16.elrepo 
.hoarch.rpm 


3. 安装 kernel 长 期 版 本 


yum --enablerepo=elrepo-kernel install kernel-lt -y # lt 
表示 long-term 的 意思 ， 长 期 维护 版 本 ， 也 可 以 将 kernel-1lt 改 为 kernel-ml， 
安装 装 主线 版 本 


4. 编辑 grub.conf 文 件 ， 修 改 Grub 引 导 顺 序 ， 确 认 刚 安装 好 的 内 核 在 哪个 位 置 ， 然 
后 设置 default 值 (从 0 开始 ) ， 一 般 新 安装 的 内 核 在 第 一 个 位 置 ， 所 以 设置 
default=0 > 


vim /etc/grub.conf 


# 以 下 是 /etc/grub.conf 的 内 容 


default=0 E 修改 该 值 即 可 
timeout=5 
splashimage=(hd0,0)/grub/splash. xpm. gz 
hiddenmenu 


title CentOS (3.10.103-1.e16.e1lrepo.x86 64) 
启 并 查看 内 核 版 本 ， 将 会 发 现 内 核 已 经 更 新 。 


安装 Docker 


1. 禁用 selinux， 因 为 selinux 和 LXC 有 冲突 ， 故 而 需要 禁用 


vim /etc/selinux/config& A X 


# 以 下 是 /etc/selinux/config 的 内 容 


# enforcing - SELinux security policy is enforced. 

# permissive - SELinux prints warnings instead of enforc 
ing. 

# disabled - No SELinux policy is loaded. 


SELINUX-disabled # 将 SELINUX 设 为 disabled， 注 意 修改 后 最 好 重启 下 机 


o 


En: 


2. 安装 Fedora EPEL 


yum -y install http://dl.fedoraproject.org/pub/epel/6/x86 64 
/epel-release-6-8.noarch.rpm 


d 


3. 安装 Docker 


yum install -y docker-io 


4. 以 守护 模式 运行 Docker 


docker -d 


5. 如 果 不 报错 ， 那 就 是 启动 成 功 了 ， 如 果 报 以 下 异常 : 


docker: relocation error: docker: symbol dm_task_get_info_wi 





th_deferred_remove, version Base not defined in file libdevm 
apper.so.1.02 with link time reference 
INFO[0000] Listening for HTTP on unix (/var/run/docker.sock) 


执行 以 下 内 容 : 


yum upgrade device-mapper-libs 


6. 将 Docker 开 机 局 动 


3.2 Docker 的 安装 


chkconfig docker on 


请 参考 : https://docs.docker.com/engine/installation/ 


参考 文档 
Windows : https://docs.docker.com/engine/installation/windows/ 


MAC : https://docs.docker.com/engine/installation/mac/ 


CentOS : https://docs.docker.com/engine/installation/linux/centos/ 
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3.3 Docker 的 常用 命令 


准备 工作 


1. 对 于 Window 有 用户， 请 点 击 Kitematic 堪 下 方 的 DOCKER CLI 按 钮 ， 在 弹出 的 命 
令 窗 体内 输入 命令 ， 不 要 在 CMD 中 测试 Docker 命 令 。 


2. 下 载 镜像 ， 以 kitematic/hello-world-nginx 为 例 : 


docker pull kitematic/hello-world-nginx 


> 


命令 
docker images 


docker search 关 
键 词 


docker pull 镜像 
名 称 


docker rmi 镜像 id 
docker run 镜像 
名 称 


docker ps 


docker version 
docker info 


docker kill @ as id 


docker start / 
stop / restart 
器 jd 


docker build -t 标 
签名 称 目录 


docker tag 


列表 本 地 所 有 镜像 


在 Docker Hub 中 搜索 镜像 


下 载 Docker 镜 像 
删除 Docker 镜 像 。 加 参数 -f 表 示 强 制 删除 。 
启动 Docker 镜 像 


列表 所 有 运行 中 的 Docker 容 器 。 该 命令 参数 比较 多 ，-a : 
列表 所 有 容器 ; -f : 过 滤 ; -q 只 列表 容器 的 id 。 

查看 Docker 版 本 信息 

查看 Docker 系 统 信 息 ， 例 如 : CPU、 内 存 、 容 器 个 数 等 等 


2, 


杀 死 id 对 应 容器 


启动 、 停 止 、 重 启 指定 容器 


构建 Docker 镜 像 ，-t 表示 指定 一 个 标签 


为 镜像 打 标 签 


更 多 命令 ， 请 输入 --help 参数 查询 ; 如 果 想 看 docker 命 令 可 输入 docker -- 
help ; 如 果 想 查询 docker run 命令 的 用 法 ， 可 输入 docker run --help ° 


docker run 


docker run 应 该 是 我 们 最 常用 的 命令 了 ， 这 边 讲解 一 下 ， 便 于 大 家 入 门 。 


ay 
zi 
3 


-d 后 台 运 行 

-P 随机 端口 映射 
指定 端口 映射 
格式 : 


ip:hostPort:containerPort 


下 ip::containerPort 
hostPort:containerPort 
containerPort 

测试 : 


1. 启动 测试 镜像 docker pull kitematic/hello-world-nginx 


docker run -d -p 91:80 kitematic/hello-world-nginx 


这 边 解释 下 docker run 的 两 个 参数 : 


-d # GGA 
-p 宿主 机 端口 :容器 端口 # 开放 容器 端口 到 宿主 机 端口 


1. 访问 : http:Wlocalhost:91 测试 ， 这 里 的 localhost 指 的 是 窑 主 机 的 主机 名 





Voila! Your nginx container is running! 


double click the website_files folder in Kitematic and edit the i 


说 明 


3.3 Dockery 3€ JH 4» 4 


M 


由 于 Docker 的 入 门 不 是 本 文章 的 主要 话题 ， 同 时 入 门 也 是 非常 简单 的 ， 所 以 不 做 太 
多 坎 述 了 ， 我 们 尽量 把 话题 聚焦 在 微服 务 上 。 如 果 有 疑问 的 童鞋 可 以 给 我 提 |ssue， 
也 可 以 fp 系列 文章 。 


TIPS 


1. 


目前 网 上 很 多 教程 还 是 boot2docker (项 目地 

址 : https://github.com/boot2docker/boot2docker) > REHEAT. £ 
者 不 建议 使 用 。 

如 果 安 装 不 成 功 ， 请 按照 提示 解决 一 下 ， 壁 如 开局 VT 技 术 等 等 。Docker 的 
提示 是 做 得 非常 好 的 ， 如 果 还 是 安装 不 上 ， 请 给 我 提 |lssue， 可 以 远程 解 
决 。 

对 于 Winodws 用 户 ， 建 议 点 击 Kitematic 左 下 角 的 DOCKER CLI， 在 弹出 来 
的 控制 人 台 输 入 Docker 命 令 ， 而 不 要 直接 在 CMD 中 输入 命令 。 


参考 文档 


http://my.oschina.net/denglz/blog/487332 
https://segmentfault.com/a/1190000000733628 
http://www.oschina.net/translate/nstalling-dockerio-on-centos-64-64-bit 
https://segmentfault.com/a/1190000000735011 
http://www.server110.com/docker/201411/11122.html 
http://dockone.io/article/152 http://www.open- 
open.com/lib/view/open1422492851548.html 


Docker WA 4» 4- : http://www.infoq.com/cn/articles/docker-command-line- 
quest/ 
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3.4 Dockerfile 常 用 指令 


间 令 的 一 般 格 式 为 指令 名 称 参数 。 


FROM 


支持 三 种 格式 : 


e FROM <image> 
e FROM <image>:<tag> 


e FROM <image>@<digest> 


FROM 指令 必须 指定 且 需 要 在 Dockerfile 其 他 指令 的 前 面 ， 指 定 的 基础 Image 可 以 是 
官方 远程 仓库 中 的 ， 也 可 以 位 于 本 地 人 仓库。 后续 的 指令 都 依赖 于 该 指令 指定 的 
image。 当 在 同一 个 Dockerfile 中 建立 多 个 镜像 时 ， 可 以 使 用 多 个 FROM 指令 。 


MAINTAINER 
格式 为 : 
e MAINTAINER <name> 


用 于 指定 维护 者 的 信息 。 


RUN 


支持 两 种 格式 : 


e RUN <command> 


e 或 RUN ["executable", "parami", "param2"] > 


RUN «command» 在 shell 终 端 中 运行 命令 ， 在 Linux 中 默认 是 /bin/sh -c 在 
Windows TX cmd /s /c RUN ["executable", "parami", "param2"] 使 用 
exec 执 行 。 指 定 其 他 终端 可 以 通过 该 方式 操作 ， 例 如 : RUN ["/bin/bash", "- 
c", "echo hello"] ， 该 方式 必须 使 用 门 而 不 能 使 用 门 ， 因 为 该 方式 会 被 转换 成 
一 个 JSON 数组 。 


CMD 


支持 三 种 格式 : 

CMD ["executable","parami","param2"] (推荐 使 用 ) 

CMD ["parami","param2"] (为 ENTRYPOINT 指 令 提 供 预 设 参 数 ) 
CMD command parami param2 (在 shell 中 执行 ) 


CMD 指 令 的 主要 目的 naan s 提 供 默认 值 。 每 个 Dockerfile 只 a 
令 ， 如 果 指 定 了 多 个 CMD 命 那么 只 有 一 条 会 被 执行 ， 如 果 启 动容 器 的 时 候 指 定 
了 运行 的 命令 ， 则 会 ee 定 的 命令 。 


LABEL 


格式 为 : 

e LABEL <key>=<value> <key>=<value> <key>=<value> ... 
为 镜像 添加 元 数据 。 使 用 "和 \ 转 换 命 令 行 ， 示 例 : 

LABEL "com.example.vendor"="ACME Incorporated" 

LABEL com.example.label-with-value="foo" 

LABEL version="1.0" 


LABEL description="This text illustrates \ 
that label-values can span multiple lines." 


EXPOSE 
格式 为 : 
e EXPOSE «port» [<port>...] 
为 Docker 容 器 设置 对 外 的 端口 号 。 在 尼 动 时 ， 可 以 使 用 -p 选 项 或 者 -P 选 项 


示例 : 


# 映射 一 个 端口 示例 

EXPOSE porti 

4 相应 的 运行 容器 使 用 的 命令 
docker run -p port1 image 
# 也 可 以 使 用 -P 选 项 启动 
docker run -P image 


H 映射 多 个 端口 示例 

EXPOSE porti port2 port3 

# 相应 的 运行 容器 使 用 的 命令 

docker run -p port1 -p port2 -p port3 image 

# 还 可 以 指定 需要 映射 到 宿主 机 器 上 的 菜 个 端口 号 

docker run -p host porti:porti -p host port2:port2 -p host port3 
:port3 image 


ENV 


格式 为 : 


e ENV <key> <value> 


e ENV <key>=<value> 


指定 环境 变量 ， 会 被 后 如 SRUN IEE —— kai p vii docker 
inspect 查看 这 个 环境 变量 ， 也 可 以 通过 docker run --env <key>=<value> 
来 修改 环境 变量 


示例 : 


ENV JAVA_HOME /path/to/java # 设置 环境 变量 JAVA_HOME 


ADD 


格式 为 : 


e ADD <src>... <dest> 


e ADD ["<src>",... "<dest>"] 


从 src 目录 复制 文件 到 容器 的 dest。 其 中 src 可 以 是 Dockerfile 所 在 目录 的 相对 路 径 ， 
也 可 以 是 一 个 URL， 还 可 以 是 一 个 压缩 包 


VER ， 


1，src 必 须 在 构建 的 上 下 文 内 ， 不 能 使 用 例如 : ADD ../somethine 
/something ， 因 为 docker build ^4 命令 首先 会 将 上 下 文 路 径 和 其 子 目 录 发 
送 到 docker daemon 

2. 如 果 src 是 一 个 URL， 同 时 dest 不 以 斜 杠 结 尾 ，dest 将 会 被 视 为 文件 ，src 对 应 
内 容 文 件 将 会 被 下 载 到 dest 

3. 如 果 src 是 一 个 URL， 同 时 dest 以 斜 杠 结尾 ，dest 将 被 视 为 目录 ，SrC 对 应 内 容 
将 会 被 下 载 到 dest 目 录 

4. 如 果 src 是 一 个 目录 ， 那 么 整个 目录 其 下 的 内 容 将 会 被 拷贝 ， 包 括 文件 系统 元 数 
JE 

b. 如 果 文 件 是 可 识别 的 压缩 包 格 式 ， 则 docker 会 自动 解压 


COPY 
格式 为 : 
e COPY <src>... <dest> 
e COPY ["<src>",... "<dest>"] (shell 中 执行 ) 


复制 本 地 端的 src 到 容器 的 dest。 和 ADD 指 令 类 似 ，COPY 不 支持 URL 和 压缩 包 


ENTRYPOINT 
格式 为 : 


e ENTRYPOINT ["executable", "parami", "param2"] 
e ENTRYPOINT command param1 param2 


指定 Docker 容 器 启动 时 执行 的 命令 ， 可 以 多 次 设置 ， 但 是 只 有 最 后 一 个 有 效 。 


VOLUME 


格式 为 : 


e VOLUME ["/data"] 


使 容器 中 的 一 个 目录 具有 持久 化 存储 数据 的 功能 ， 该 目录 可 以 被 容器 本 身 使 用 ， 也 
可 以 共享 给 其 他 容器 。 当 容器 中 的 应 用 有 持久 化 数据 的 需求 时 可 以 在 Dockerfile 中 
使 用 该 指令 。 


设置 局 动容 器 的 用 户 ， 默 认 是 root 用 户 。 


WORKDIR 
格式 为 : 
e WORKDIR /path/to/workdir 


切换 目录 指令 ， 类 似 于 cd 命令 ， 对 RUN、CMD、ENTRYPOINT 生 效 。 


格式 为 : 
e ARG <name>[=<default value>] 


ARG 指 令 定 义 一 个 变量 。 


ONBUILD 
格式 为 : 
e ONBUILD [INSTRUCTION] 


指定 当 建 立 的 镜像 作为 其 他 镜像 的 基础 时 ， 所 执行 的 命令 。 


3.4 Dockerfile 常 用 指令 


其 他 


STOPSINGAL HEALTHCHECK SHELL 由 于 并 不 是 很 常用 ， 所 以 不 做 讲解 了 。 有 
兴趣 的 可 以 前 往 https://docs.docker.com/engine/reference/builder/ 扩展 阅读 。 


参考 文档 : 


Dockerfile 文 档 : https://docs.docker.com/engine/reference/builder/#dockerfile- 
reference 


Dockerfile 最 住 实践 : https://docs.docker.com/engine/userguide/eng- 
image/dockerfile_best-practices/#build-cache 


Docker # 
3& : http://udn.yyuap.com/doc/docker_practice/advanced_network/port_mapping.h 
tml 


Docker +4 
籍 : https://philipzheng.gitbooks.io/docker_practice/content/dockerfile/instructions. 
html 


Dockerfile 讲 解 : http://blog.csdn.net/qinyushuang/article/details/43342553 
Dockerfile 讲 解 : http://blog.csdn.net/wsscy2004/article/details/25878223 
Dockerfile 网 络 : http://my.oschina.net/ghm7753/blog/522809 


COPY 和 ADD 的 区 
别 : http://blog.163.com/digoal@126/blog/static/163877040201410341236664/ 


CMD 与 ENTRYPOINT 的 区 别 : http://cloud.51cto.com/art/201411/457338.htm 
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3.5 Docker 私 有 仓库 的 搭建 与 使 用 
和 Maven 一 样 ，Docker 不 仅 提供 了 一 个 中 央 仓 库 ， 同 时 也 允许 我 们 搭建 私有 仓库 。 
如 果 读 者 对 Maven 有 所 了 解 ， 将 会 很 容易 理解 私有 仓库 的 优势 : 


e 节省 带宽 ， 镜 像 无 需 从 中 央 仓 库 下 载 ， 只 需 从 私有 仓库 中 下 载 即 可 
e 对 于 私有 仓库 中 已 有 的 镜像 ， 提 升 了 下 载 速 度 
e 便于 内 部 镜像 的 统一 管理 


下 面 我 们 来 讲解 一 下 如 何 搭 建 、 使 用 私有 仓库 


准备 工作 


准备 两 台 安 装 有 Docker 的 CentOS7 的 机 器 ， 主 机 规划 如 下 ( 仅 供 参考 ) 


主机 IP 角色 
nodeO 192.168.11.143 Docker 开 发 机 
node1 192.168.11.144 Docker 私 有 仓库 


安装 、 使 用 私有 仓库 


网 上 有 很 多 docker-registry 的 教程 ， 但 是 docker-registry 已 经 过 时 ， 并 
且 已 经 2 年 不 维护 了 。 详 见 https://github.com/docker/docker-registry ， 故 而 本 文 不 
做 探讨 ， 对 docker-registry 有 兴趣 的 童鞋 可 以 查阅 本 节 的 参考 文档 。 


本 节 讲 解 registry V2 > registry V2 需要 Docker 版 本 高 于 1.6.0。registry V2 要 求 使 用 
https 访 问 ， 那 么 我 们 先 做 一 些 准备 ， 为 了 方便 ， 这 边 模拟 以 域 
名 reg.itmuch.com 进行 讲解 。 


使 用 域名 搭建 https 的 私有 仓库 


e 首先 修改 两 台 机 器 的 hosts， 配 置 192.168.11.144 到 reg.itmuch.com 的 
映射 


echo '192.168.11.144 reg.itmuch.com'>> /etc/hosts 


e 既然 使 用 https， 那 么 我 们 需要 生成 证 书 ， 本 文 讲解 的 是 使 用 openss| 自 签名 证 
书 ， 当 然 也 可 以 使 用 诸如 Let's Encrypt 等 工具 生成 证 书 ， 首 先 在 node1 机 
器 上 生成 key : 


mkdir -p ~/certs 
cd ~/certs 
openssl genrsa -out reg.itmuch.com.key 2048 


再 生成 密 钥 文件 : 


openssl req -newkey rsa:4096 -nodes -sha256 -keyout reg.itmuch.c 
om.key -x509 -days 365 -out reg.itmuch.com.crt 


会 有 一 些 信息 需要 


Es 
Ay) 


Country Name (2 letter code) [XX]:CN 
H 你 的 国家 名 称 
State or Province Name (full name) []:JS 
# 省 份 
Locality Name (eg, city) [Default City]:NJ 
# 所 在 城市 
Organization Name (eg, company) [Default Company Ltd] :ITMUCH 
# 组 织 名 称 
Organizational Unit Name (eg, section) []:ITMUCH 
# 组 织 单 元 名 称 
Common Name (eg, your name or your server's hostname) []:reg.itm 
uch.com # BA 
Email Address []:eacdy0000@126.com 
# 邮箱 


这 样 自 签名 证 书 就 制作 完成 了 。 


e 由 于 是 自 签名 和 证书， 默认 是 不 受 Docker 信 任 的 ， 故 而 需要 将 证 书 添 加 到 Docker 
的 根 证 书 中 ，Docker 在 CentOS 7 中 ， 证 书 存放 路 径 


是 /etc/docker/certs.d/ 域 名 


nodei 端 : 


mkdir -p /etc/docker/certs.d/reg.itmuch.com 
cp ~/certs/reg.itmuch.com.crt /etc/docker/certs.d/reg.itmuch.com 
/ 


node@ 35: 将 生成 的 证 书 下 载 到 根 证 书 路 径 


mkdir -p /etc/docker/certs.d/reg.itmuch.com 
scp root@192.168.11.144:/root/certs/reg.itmuch.com.crt /etc/dock 
er/certs.d/reg.itmuch.com/ 


e 重新 启动 nodeg 和 nodei Docker 


service docker restart 


e 在 nodei 上 启动 私有 仓库 


首先 切换 到 家 目录 中 ， 这 一 步 不 能 少 ， 原 因 是 下 面 的 -V 挂 载 了 人 证书， 如果 不 切换 ， 
将 会 引用 不 到 证 书 文 件 。 


cd ~ 


启动 Docker 私 有 仓库 (注意 : 如 果 直 接 粘贴 运行 ， 请 删除 掉 注 释 ) 


docker run -d -p 443:5000 --restart=always --name registry \ 

-v ^pwd' /certs:/certs \ # 将 “ 当 
前 目录 /certs” 挂 载 到 容器 的 %“/certs” 

-v /opt/docker-image:/opt/docker-image \ 


-e STORAGE_PATH=/opt/docker-image \ 
H 指定 容器 内 存储 镜像 的 路 径 

-e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/reg.itmuch.com.crt \ 
# 指定 证 书 文件 

-e REGISTRY_HTTP_TLS_KEY=/certs/reg.itmuch.com.key \ 
# 指定 key 文件 

registry:2 


其 中 ， 之 所 以 挂 载 /opt/docker-image 目 录 ， 是 为 了 防止 私有 仓库 容器 被 删除 ， 私 有 
仓库 中 的 镜像 也 会 丢失 。 


e 在 nodeO 上 测试 ， 将 镜像 push 到 私服 


docker pull kitematic/hello-world-nginx 
docker tag kitematic/hello-world-nginx reg.itmuch.com/kitematic/ 
hello-world-nginx # 为 本 地 镜像 打 标 签 
docker push reg.itmuch.com/kitematic/hello-world-nginx 
# 将 镜像 push 到 私服 


会 发 现 如 下 内 容 : 


The push refers to a repository [reg.itmuch.com/kitematic/hello- 
world-nginx ] 

5f70bf18a086: Pushed 

b51acdd3ef48: Pushed 

3f47fFF454588: Pushed 


latest: digest: sha256:d3e1883b703c39556f2f09da14cc3b820f69a4343 
6655c882c0cOdedOdda6a4b size: 3226 


359] €, 2: push s xj » 


e 从 私服 中 下 载 镜 像 : 


docker pull reg.itmuch.com/kitematic/hello-world-nginx 


配置 登录 认证 
在 很 多 场景 下 ， 我 们 需要 用 户 登 录 后 才能 访问 私有 仓库 ， 那 么 我 们 可 以 如 下 操作 : 
建立 在 上 文生 成 证 书 ， 同 时 重启 过 Docker 服 务 的 前 提 下 ， 我 们 讲解 一 下 如 何 配 置 : 


e 为 防止 端口 冲突 ， 我 们 首先 删除 或 停止 之 前 启动 好 的 私有 仓库 : 


docker kill registry 


e 在 node1 机 器 上 安装 httpd-tools 


yum install httpd-tools 


e 在 node 机 器 上 创建 密码 文件 ， 并 添加 一 个 用 户 testuser ^» FY 


是 testpassword 


cde 
mkdir auth 
htpasswd -Bbn testuser testpassword > auth/htpasswd 


e 在 node1 机 器 上 切换 到 ~ 目录 ， 并 启动 私有 仓库 (注意 : 如 果 直 接 粘 贴 运 
行 ， 请 删除 掉 注 释 ) 


docker run -d -p 443:5000 --restart=always --name registry2 \ 
-v /opt/docker-image:/var/lib/registry \ 
H 挂 载 容器 内 存储 镜像 路 径 到 宿主 机 
-V pwd /certs:/certs \ 
-e REGISTRY HTTP TLS CERTIFICATE-/certs/reg.itmuch.com.crt \ 
-e REGISTRY HTTP TLS KEY-/certs/reg.itmuch.com.key \ 
-Vv pwd /auth:/auth \ 
-e "REGISTRY AUTH-htpasswd" \ 
-e "REGISTRY AUTH HTPASSWD REALM-Registry Realm" \ 
-e REGISTRY AUTH HTPASSWD PATH-/auth/htpasswd \ 
registry:2 


e 测试 : 
docker push reg.itmuch.com/kitematic/hello-world-nginx 
提示 : 


461f75075df2: Image push failed 
no basic auth credentials 


说 明 需 要 认证 。 


我 们 登陆 一 下 ， 执 行 : 
docker login reg.imuch.com 
再 次 执行 
docker push reg.itmuch.com/kitematic/hello-world-nginx 


就 可 以 正常 push 镜 像 到 私有 仓库 了 。 


注意 : 如 果 想 要 从 私有 仓库 上 下 载 镜像 ， 同 样 需 要 登录 。 


参考 文档 : 


3.5 Docker 私 有 仓库 的 搭建 与 使 用 


官方 文档 : https://docs.docker.com/registry/deploying/#/running-a-domain-registry 


Docker Registry V2 htpasswd 认 证 方式 搭 
建 : http://www.tuicool.com/articles/VMZZveM 


Docker Registry V2 搭建 : http://www.tuicool.com/articles/6jEJZj 
Docker Registry V2 搭建 : http://tomhat.iteye.com/blog/2304098 
Docker Registry V1 搭建 : http://blog.csdn.net/wsscy2004/article/details/26279569 


非 认 证 的 Docker Registry Vi 
建 : http://blog.csdn.net/wangtaoking1/article/details/44180901 


带 认 证 的 Docker Registry V14 
建 : http://snoopyxdy.blog.163.com/blog/static/601174402015823741997/ 


Docker 专 题 汇总 ; http://www.zimug.com/360.html 


Docker 疑 难 解 答 : https://segmentfault.com/q/1010000000938076 
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3.6 使 用 Dockerfile 构 建 Docker 镜 像 
下 面 我 们 以 microservice-discovery-eureka 项 目 为 例 ， 我 们 首先 执行 


mvn clean package # 使 用 Maven 打 包 项 目 


将 项 目 构建 成 jar 包 : microservice-discovery-eureka-0.0.1-SNAPSHOT. jar 
， 那么 如 果 我 们 想 要 尼 动 项 目 则 只 需要 在 microservice-discovery-eureka- 
0.0.1-SNAPSHOT.jar 所 在 的 目录 ( 即 项 目的 target 目 录 ) 执行 : 


java -jar microservice-discovery-eureka-0.0.1-SNAPSHOT. jar 
那么 如 果 我 们 现在 想 要 将 项 目 在 Docker 容 器 中 运行 ， 需 要 怎么 做 呢 ? 


使 用 Dockerfile 构 建 Docker 镜 像 


e 在 microservice-discovery-eureka-0.0.1-SNAPSHOT.jar 所 在 目录 (R 
UPP : 项 目 构建 后 的 target 目 录 ， 当 然 也 可 以 将 jar 文 件 拷贝 到 其 他 任意 路 
径 ) ， 创 建文 件 ， 命 名 为 Dockerfile 


# 基于 哪个 镜像 
FROM java:8 


H 将 本 地 文件 夹 挂 载 到 当前 容器 

VOLUME /tmp 

# 拷贝 文件 到 容器 ， 也 可 以 直接 写成 ADD microservice-discovery-eureka-0.0 
.1-SNAPSHOT. jar /app.jar 

ADD microservice-discovery-eureka-0.0.1-SNAPSHOT.jar app. jar 


RUN bash -c 'touch /app.jar' 


4 开放 8761 端 口 
EXPOSE 8761 


# 配置 容器 启动 后 执行 的 命令 
ENTRYPOINT ["java","-Djava.security.egd-file:/dev/./urandom", "- j 
aui d appeal 


e 构建 docker 镜 像 ， 执 行 : 


docker build -t eacdy/test1 . 4 格式 :docker build -t 标签 
名 称 Dockerfile 的 相对 位 置 


构建 成 功 : Successfully built a7cc6f4de088 > 


e 户 动 镜像 


docker run -p 8761:8761 eacdy/test1 
e 访问 http://Docker 宿 主机 IP:8761 ， 我 们 会 发 现 Eureka 能 够 正常 被 访问 。 


参考 文档 


3.6 4% M Dockerfile24 3€ Docker 4 1% 
AT Dockerfile# #2 JAVA Tomcatié 44 3f 
3t, : http:/Awww.blogjava.net/yongboy/archive/2013/12/16/407643.html 


Docker 3: 3L È At Ap Z wy 3 fe 
& : http://blog.csdn.net/zssuregh/article/details/52009043 


Dockerfilet# f£ : http://blog.csdn.net/wsscy2004/article/details/25878223 


Dockerfile RUN/CMD/ENTRYPOINT 4 4-77 
解 : http://blog.163.com/digoal@126/blog/static/163877040201410411715832 
/ 


如 何 使 用 Dockerfile 构 建 镜 
4% : http://blog.csdn.net/qinyushuang/article/details/43342553 
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3.7 使 用 Maven 插 件 构 建 Docker 镜 像 


工具 


工 欲 善 其 事 ， 必 先 利 其 器 。 笔 者 经 过 调研 ， 有 以 下 几 款 Docker 的 Maven 插 件 进 入 笔 
者 视野 : 


插件 名 称 官方 地 址 
docker-maven-plugin https://github.com/spotify/docker-maven-plugin 
docker-maven-plugin https://github.com/fabric8io/docker-maven-plugin 
docker-maven-plugin https://github.com/bibryam/docker-maven-plugin 


笔者 从 Stars、 文 档 易 用 性 以 及 更 新 频率 三 个 纬度 考虑 ， 选 用 了 第 一 款 。 


使 用 插件 构建 Docker 镜 像 
简单 使 用 
我 们 以 之 前 的 项 目 : microservice-discovery-eureka 为 例 : 


e 在 pom.xml 中 添加 下 面 这 段 


2 7 48 A Mavy Ja i Clearzz4g 
3.7 12 F| Mavendé fF453 3$ Docker 1% 


«build» 
«plugins» 
<!-- docker 的 maven 插 件 ， 官 网 : https://github.com/spoti 
fy/docker-maven-plugin --> 

<plugin> 
«groupId»com.spotify«/groupId» 
<artifactId>docker -maven-plugin</artifactId> 
<version>0.4.12</version> 


<configuration> 
<!-- 注意 jmageName 一 定 要 是 符合 正则 [a-z0-9-_.] 的 


， 否则 构建 不 会 成 功 --> 
<!-- 详 见 : https://github.com/spotify/docker- 
maven-plugin Invalid repository name ... only [a-z0-9- .] are 
allowed- -> 
<imageName>microservice-discovery-eureka</im 
ageName> 
<baseImage>java</baseImage> 
<entryPoint>["java", "-jar", "/${project.bui 
ld.finalName).jar"]«/entryPoint» 
«resources» 
«resource» 
<targetPath>/</targetPath> 
<directory>${project.build.directory} 
</directory> 
<include>${project.build.finalName}. 
jar</include> 
</resource> 
</resources> 
</configuration> 
</plugin> 
</plugins> 
</build> 


国 IE 


e 执行 命令 : 


mvn clean package docker:build 


e 我 们 会 发 现 控制 台 有 类 似 如 下 内 容 : 


[INFO] Building image microservice-discovery-eureka 
Step 1 : FROM java 
Pulling from library/java 
Digest: sha256:581a4afcbbedd8fdf194d597cb5106c1f91463024fb3a49a2 
d9f025165eb675f 
Status: Downloaded newer image for java:latest 
---» ea40c858f006 
Step 2 : ADD /microservice-discovery-eureka-0.0.1-SNAPSHOT.jar / 
/ 
---> d1c174083bca 
Removing intermediate container 91913d847c20 
Step 3 : ENTRYPOINT java -jar /microservice-discovery-eureka-0.0 
. 1- SNAPSHOT. jar 
---» Running in Of2aeccdfd46 
---» d57b027ca65a 
Removing intermediate container Of2aeccdfd46 
Successfully built d57b027ca65a 
[INFO] Built microservice-discovery-eureka 
[INFO] --------------------------------------------------------- 


[INFO] ~~ =~ ~~ nnn nn nn nnn 


[INFO] Total time: 01:38 min 
[INFO] Finished at: 2016-09-18T01:05:05-07:00 
[INFO] Final Memory: 40M/198M 


茶 音 ， 构 建成 功 了 。 


e 我 们 执行 docker images 会 发 现 该 镜像 已 经 被 构建 成 功 : 


REPOSITORY TAG IMAGE ID 
CREATED SIZE 
microservice-discovery-eureka latest d57b027ca65a 


About a minute ago 681.5 MB 


e 户 动 镜像 


docker run -p 8761:8761 microservice-discovery-eureka 


我 们 会 发 现 该 Docker 镜 像 会 很 快 地 启动 。 
e 访问 测试 


访问 http://Docker 窒 主机 IP:8761 ， 能 够 正常 看 到 Eureka 界 面 。 


使 用 Dockerfile 进 行 构建 


上 文 讲述 的 方式 是 最 简单 的 方式 ， 很 多 时 候 ， 我 们 还 是 要 借助 Dockerfile 进 行 构建 
的 ， 首 先 我 们 在 /microservice-discovery-eureka/src/main/docker 目 录 下 ， 建 立 文件 
Dockerfile 


FROM java:8 

VOLUME /tmp 

ADD microservice-discovery-eureka-0.0.1-SNAPSHOT.jar app.jar 

RUN bash -c 'touch /app.jar' 

EXPOSE 9000 

ENTRYPOINT ["java","-Djava.security.egd-file:/dev/./urandom", "-j 
ar","/app.jar"] 


修改 pom.xml 


<build> 
<plugins> 
<!-- docker 的 maven 插 件 ， 官 网 : https://github.com/spoti 
fy/docker-maven-plugin --> 
<plugin> 
«groupId»com.spotify«/groupId» 
<artifactId>docker -maven-plugin</artifactId> 
<version>0.4.12</version> 
<configuration> 
<!-- 注意 ImageName 一 定 要 是 符合 正则 [a-z9-9-_,] 的 
， 否则 构建 不 会 成 功 --> 
<!-- 详 见 : https://github.com/spotify/docker- 
maven-plugin Invalid repository name ... only [a-z0-9- .] are 
allowed- -> 
<imageName>microservice-discovery-eureka-doc 
kerfile</imageName> 
<!-- 指定 Dockerfile 所 在 的 路 径 --> 
<dockerDirectory>${project.basedir}/src/main 
/docker</dockerDirectory> 
<resources> 
<resource> 
<targetPath>/</targetPath> 
<directory>${project.build.directory} 
</directory> 
<include>${project.build.finalName}. 
jar</include> 
</resource> 
</resources> 
</configuration> 
</plugin> 
</plugins> 
</build> 


Eo E] 
其 他 步骤 一 样 。 这 样 即 可 使 用 Dockerfile 进 行 构 建 Docker 镜 像 啦 。 
将 Docker 镜 像 push 到 DockerHub 上 


e 首先 修改 Maven 的 全 局 配置 文件 settings.xml， 添 加 以 下 段落 


3.7 使 用 Maven 插 件 构建 Docker 镜 像 


<servers> 
<server> 
<id>docker -hub</id> 
<username>ts 4) DockerHub/i] P 4</username> 
<password>#% 49 DockerHub # 43 </password> 
<configuration> 
<email>tk #4) Docker Hub? #4 </email> 
</configuration> 
</server> 
</servers> 


e 在 DockerHub 上 创建 repo, 例 如 : test » 4» FA 


e 项 目 pom.xml 修 改 为 如 下 : 注意 imageName 的 路 径 要 和 repo 的 路 径 一 臻 


<build> 
<plugins> 
<!-- docker 的 maven 插 件 ， 官 网 : https://github.com/spoti 
fy/docker-maven-plugin --> 
<plugin> 
«groupId»com.spotify«/groupId» 
<artifactId>docker -maven-plugin</artifactId> 
<version>0.4.12</version> 


<configuration> 
<!-- 注意 jmageName 一 定 要 是 符合 正则 [a-z0-9-_.] 的 


， 否则 构建 不 会 成 功 --> 
<!-- 详 见 : https://github.com/spotify/docker- 
maven-plugin Invalid repository 
name ... only [a-z0-9- .] are allowed --> 


<!-- 如 果 要 将 docker 镜 像 push 到 DockerHub 上 去 的 话 ， 
这 边 的 路 径 要 和 repo 路 径 一 致 --> 

<imageName>eacdy/test</imageName> 

<!-- 指定 Dockerfile 所 在 的 路 径 --> 

<dockerDirectory>${project.basedir}/src/main 
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/docker</dockerDirectory> 
<resources> 
<resource> 
<targetPath>/</targetPath> 
<directory>${project.build.directory} 


</directory> 
<include>${project.build.finalName}. 
jar</include> 
</resource> 
</resources> 
<!-- 以 下 两 行 是 为 了 docker push 到 DockerHub 使 用 的 
3555 
«serverId»docker -hub</serverId> 
<registryUrl>https://index.docker.i0/vi/</re 
gistryUrl> 
</configuration> 
</plugin> 
</plugins> 
</build> 


Eeo '— —mU Ó[ 


e 执行 命令 : 
mvn clean package docker:build -DpushImage 


Je 


e 搞定 ， 等 构建 成 功 后 ， 我 们 会 发 现 Docker 镜 像 已 经 被 push 到 DockerHub 上 了 » 


将 镜像 push 到 私有 仓库 
在 很 多 场景 下 ， 我 们 需要 将 镜像 push 到 私有 仓库 中 去 ， 这 边 为 了 讲解 的 全 面 性 ， 私 
有 仓库 采用 的 是 配置 登录 认证 的 私有 仓库 。 


e 和 push 镜 像 到 DockerHub 中 一 样 ， 我 们 首先 需要 修改 Maven 的 全 局 配置 文件 
settings.xml， 添 加 以 下 段落 


<servers> 
<server> 
<id>docker-registry</id> 
<username>*% 49 DockerHub A P 4</username> 
<password>#% 49 DockerHub # 43 «/password» 
<configuration> 
<email>tk #4) Docker Hub? #4 </email> 
</configuration> 
</server> 
</servers> 


e 将 项 目的 pom.xml 改 成 如 下 ， 


<plugin> 
«groupId»com.spotify«c/groupId» 
<artifactId>docker -maven-plugin</artifactId> 
<version>0.4.12</version> 
<configuration> 
«1-- 路 径 为 : 私有 仓库 地 址 /你 想 要 的 镜像 路 径 --> 
<imageName>reg.itmuch.com/test -pull-registry</imageName> 
<dockerDirectory>${project.basedir }/src/main/docker</dockerD 
irectory> 


<resources> 
<resource> 
<targetPath>/</targetPath> 
<directory>${project.build.directory}</directory> 
<include>${project.build.finalName}.jar</include> 
</resource> 
</resources> 


<!-- 与 maven 配 置 文件 settings.xml 一 致 --> 
<serverId>docker-registry</serverId> 
</configuration> 
</plugin> 


mvn clean package docker:build -DpushImage 


稍 等 片刻 ， 将 会 push 成 功 。 
e 如 果 想 要 从 私服 上 下 载 该 镜像 ， 执 行 : 


docker login reg.itmuch.com # 然后 输入 账号 和 密码 
docker pull reg.itmuch.com/test-pull-registry 


将 插件 绑 定 在 东 个 phase 执 行 


在 很 多 场景 下 ， 我 们 有 这 样 的 需求 ， 例 如 执行 mvn clean package 时 ， 自 动 地 
为 我 们 构建 docker 镜 像 ， 可 以 吗 ? 答案 是 肯定 的 。 我 们 只 需要 将 插件 的 goal 7f 
定 在 某 个 phase 即 可 。 


所 谓 的 phase 和 goal， 可 以 这 样 理解 : maven 命 令 格式 是 : mvn phase:goal ， 
例如 myn package docker:build 那么 ，package 和 docker 都 是 
phase’ build 则 是 goal 。 


下 面 是 示例 : 


首先 配置 属性 : 


<properties> 
<docker .image.prefix>reg.itmuch.com</docker .image.prefix> 
</properties> 


插件 配置 : 


<build> 
<plugins> 
<plugin> 
<groupId>com. spotify</groupIid> 
<artifactId>docker -maven-plugin</artifactId> 
<executions> 
<execution> 
<id>build-image</id> 
<phase>package</phase> 
<goals> 
<goal>build</goal> 
</goals> 
</execution> 
</executions> 
<configuration> 
<imageName>${docker .image.prefix}/${project.artifactId} 
</imageName> 
<baseImage>java</baseImage> 
<entryPoint>["java", "-jar", "/${project.build.finalNa 
me}. jar" ]</entryPoint> 
<resources> 
<resource> 
<targetPath>/</targetPath> 
<directory>${project.build.directory}</directory> 
<include>${project .build.finalName}.jar</include> 
</resource> 
</resources> 
</configuration> 
</plugin> 
</plugins> 
</build> 


Ep Saez m] 


如 上 ， 我 们 只 需要 添加 : 


<executions> 
<execution> 
<id>build-image</id> 
<phase>package</phase> 
<goals> 
<goal>build</goal> 
</goals> 
</execution> 
</executions> 


即 可 。 本 例 指 的 是 讲 docker 的 build 目 标 ， 绑 定 在 package 这 个 phase 上 。 也 就 是 
说 ， 用 户 只 需要 执行 mvn package ， 就 自动 执行 了 mvn docker:build 。 


常见 异常 
连接 不 上 2375 (一 般 在 Win7 上 出 现 ) 


Connect to localhost:2375 [localhost/127.0.0.1, localhost/0:0:0: 
0:0:0:0:1] failed: Connection refused: connect -> [Help 1] 
解决 步骤 : 
e 输入 docker-machine env 
$Env:DOCKER TLS VERIFY = "1" 
$Env:DOCKER HOST = "tcp://192.168.99.100:2376" 


$Env:DOCKER CERT PATH = "C:\Users\Administrator\.docker\machine\ 
machinesNdefault 


e 为 插件 添加 配置 


<!-- 解决 Connect to localhost:2375 的 问题 的 其 中 一 种 方式 ， 注 意 要 跟 docker 
-machine env 相 一 致 --> 
<dockerHost>https://192.168.99.100:2376</dockerHost> 

<dockerCertPath>C: \Users\Administrator\.docker\machine\machi 
nes\default</dockerCertPath> 


修改 后 插件 配置 变 为 : 


<plugin> 
«groupId»com.spotify«/groupId» 
<artifactId>docker -maven-plugin</artifactId> 
<version>0.4.12</version> 
<configuration> 
<imageName>eacdy/test</imageName> 
<dockerDirectory>${project.basedir}/src/main/docker</doc 
kerDirectory> 


«1-- 解决 Connect to Localhost :2375 的 问题 的 其 中 一 种 方式 ， 注 意 
要 跟 docker-machine env 相 一 致 --> 
<dockerHost>https://192.168.99.100:2376</dockerHost> 
<dockerCertPath>C: \Users\Administrator\.docker\machine\m 
achines\default</dockerCertPath> 
<resources> 
<resource> 
<targetPath>/</targetPath> 
<directory>${project.build.directory}</directory> 


<include>${project .build.finalName}.jar</include> 


</resource> 
</resources> 
<!-- 以 下 两 行 是 为 了 docker push 到 DockerHub 使 用 的 。 --» 


<ServerId>docker-hub</serverId> 
<registryUrl>https://index.docker.i10/vi/</registryUrl1> 
</configuration> 
</plugin> 


4 ae pi 











3.7 使 用 Maven 插 件 构建 Docker 镜 像 


e 参考 : https://github.com/spotify/docker-maven-plugin/issues/116 


TIPS 
1. imageName 必 须 符 合 正 则 [a-z0-9- .]， 和 否则 将 会 构建 失败 


2. 插件 默认 使 用 localhost:2375 去 连接 Docker， 如 果 你 的 Docker 端 口 不 是 2375， 
需要 配置 环境 变量 DOCKER_HOST=tcp://<host>: 2375 


代码 地 址 ( 任 选 其 一 ) 


https://git.oschina.net/itmuch/spring-cloud- 
study/tree/master/docker/microservice-discovery-eureka 
https://github.com/eacdy/spring-cloud-study/tree/master/docker/microservice- 
discovery-eureka 


参考 文档 


http://developer.51cto.com/art/201404/434879.htm https://linux.cn/article- 
6131-rss.html 
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3.8 Docker Compose 


前 文 提 到 的 Dockerfile 可 以 让 用 户 管 理 一 个 单独 的 容器 ， 那 么 如 果 我 要 管理 多 个 容 
器 呢 ， 例 如 : 我 需要 管理 一 个 Web 应 用 的 同时 还 要 加 上 其 后 端的 数据 库 服务 容器 
呢 ? Compose 就 是 这 样 的 一 个 工具 。 让 我 们 看 下 官网 对 Compose 的 定义 : 


Compose 是 一 个 用 于 定义 和 运行 多 容器 的 Docker 应 用 的 工具 。 使 用 Compose， 你 
i n 文件 (yaml 格 式 ) 中 配置 你 应 用 的 服务 ， 然 后 使 用 一 个 命令 ， 即 可 
建 并 启动 配置 中 引用 的 所 有 服务 。 下 面 我 们 进入 Compose 的 实战 吧 。 


我 们 使 用 最 新 的 Docker Compose 1.8.0 进 行 讲解 。 


3.8.1 Docker Compose £^ X X 


3 % Compose 


人 > AE 


Compose 的 安装 有 多 种 方式 ， 例 如 通过 shell 安 装 、 通 过 pip 安 装 、 以 及 将 compose 
作为 容器 安装 等 等 。 本 文 讲 解 通过 shell 安 装 的 方式 。 其 他 安装 方式 如 有 兴趣 ， 可 以 
查看 Docker 的 官方 文档 : https://docs.docker.com/compose/install/ 


e FB docker-compose ， 并 放 到 /usr/local/bin/ 


curl -L https://github.com/docker/compose/releases/download/1.8. 
0/docker-compose-' uname -S - uname -mò > /usr/local/bin/docker -c 
ompose 


e. ADocker Compose 脚 本 添加 执行 权限 


chmod +x /usr/local/bin/docker -compose 


docker-compose --version 


结果 显示 : 


docker-compose version 1.8.0, build f3628c7 
说 明 Compose 已 经 成 功 安装 完成 了 。 


安装 Compose 命 令 补 全 工具 


按照 上 文 讲解 ， 我 们 已 经 成 功 地 安装 完 Docker Compose。 但 是 ， 我 们 输 
A docker-compose 命令 ， 按 下 TAB 键 ， 发 现 此 时 Compose 并 没有 给 我 们 该 命令 
的 提示 ， 那 么 如 何 让 命令 给 我 们 提示 呢 ? 我 们 需要 安装 Compose 命 令 补 全 工具 。 


Compose 命 令 补 全 在 Bash 和 Zsh 下 的 安装 方式 不 同 ， 由 于 笔者 是 使 用 CentOS 7 进 
行 讲解 的 ， 而 CentOS 7 默认 使 用 Bash， 故 而 本 文 只 讲解 命令 补 全 在 Bash 下 的 安 
装 ， 其 他 Shell 以 及 其 他 系统 上 的 安装 ， 请 查看 Docker 的 官方 文 

档 : https://docs.docker.com/compose/completion/ 


curl -L https://raw.githubusercontent.com/docker/compose/$(docke 
r-compose version --short)/contrib/completion/bash/docker -compos 
e » /etc/bash completion.d/docker-compose 


这 样 ， 在 重新 登录 后 ， 输 入 docker-compose 命令 后 ， 按 下 TAB 键盘 ， 效 果 如 
Te 


[root@localhost ~]# docker-compose 


build config down exec kill pause ps p 
ush rm scale stop up 

bundle create events help logs port pull r 
estart run start unpause version 


发 现 已 经 可 以 自动 提示 了 。 


3.8.2 Docker Compose 入 门 示例 


Compose 的 使 用 非常 简单 ， 只 需要 编写 一 个 docker-compose.yml ， 然 后 使 

用 docker-compose 命令 操作 即 可 。 docker-compose.yml 描述 了 容器 的 配 
置 ， 而 docker-compose 命令 描述 了 对 容器 的 操作 。 我 们 首先 通过 一 个 示例 快速 
AT] : 


还 记得 前 文 ， 我 们 使 用 Dockerfile 为 项 目 microservice-discovery-eureka 构建 
Docker 镜 像 吗 ? 我 们 还 以 此 项 目 为 例 ， 在 node0 (192.168.11.143) 这 人 台 机 器 上 测 


TX, o 


e 我 们 在 microservice-discovery-eureka-0.0.1-SNAPSHOT.jar 所 在 目录 
的 上 一 级 目录 ， 创 建 docker-compose.yml 文件 。 目录 树 结构 : 


I— docker-compose.yml 
L— eureka 
I— Dockerfile 
L— microservice-discovery-eureka-0.0.1-SNAPSHOT. jar 


后 在 docker-compose.yml 中 添加 内 容 如 下 


eureka: 
build: ./eureka 
ports: 
= 8761:98761" 
expose: 
- 8761 


e 在 docker-compose.yml 所 在 路 径 执行 


docker-compose up 


发 现 打 印 日 志 : 


eureka 1 | 2016-09-23 02:23:46.163 INFO 1 --- [ main 
] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on p 
ort(s): 8761 (http) 

eureka_1 | 2016-09-23 02:23:46.164 INFO 1 --- [ main 
] c.n.e.EurekaDiscoveryClientConfiguration : Updating port to 87 
61 

eureka 1 | 2016-09-23 02:23:46.167 INFO 1 --- [ main 
] c.itmuch.cloud.study.EurekaApplication : Started EurekaAppli 
cation in 8.791 seconds (JVM running for 9.939) 

eureka 1 | 2016-09-23 02:24:46.016 INFO 1 --- [a-EvictionTimer 
] c.n.e.registry.AbstractInstanceRegistry : Running the evict t 
ask with compensationTime Oms 


e 访问 : http:// 宿 主机 IP:8761/ ^ AX 
为 : http://192.168.11.143:8761/ ， 发 现 可 以 正常 启动 。 


3.8.3 docker-compose.yml $ M TA 


image 
指定 镜像 名 称 或 者 镜像 id， 如 果 该 镜像 在 本 地 不 存在 ，Compose 会 尝试 pull 下 来 。 


示例 : 
image: java 
build 
指定 Dockerfile 文 件 的 路 径 。 可 以 是 一 个 路 径 ， 例如: 


build: ./dir 


也 可 以 是 一 个 对 象 ， 用 以 指定 Dockerfile 和 参数 ， 例 如 : 
build: 
context: ./dir 
dockerfile: Dockerfile-alternate 


args: 
buildno: 1 


command 
覆盖 容器 启动 后 默认 执行 的 命令 。 


示例 : 
command: bundle exec thin -p 3000 
也 可 以 是 一 个 list， 类 似 于 Dockerfile 总 的 CMD 指 令 ， 格 式 如 下 : 


command: [bundle, exec, thin, -p, 3000] 


links 


链接 到 其 他 服务 中 的 容器 。 可 以 指定 服务 名 称 和 链接 的 别名 使 用 SERVICE: ALIAS 


的 形式 ， 或 者 只 指定 服务 名 称 ， 示 例 : 


web: 
links: 
- db 
- db:database 
- redis 


external_links 


vu 


iz 


PED did cL yml 外 部 的 容器 ， 其 至 并 非 Compose 管 理 的 容器 ， 特 
别 是 对 于 那些 提供 共享 容器 或 共同 服务 。 格 式 跟 links 类 似 ， 示 例 : 


external_links: 
- redis 1 
- project db 1:mysql 
- project db 1:postgresql 


ports 


暴露 端口 信息 。 使 用 宿主 端口 :容器 端口 的 格式 ， 或 者 仅仅 指定 容 
主机 将 会 随机 指定 端口 ) ， 类 似 于 docker run -p ， 示 例 : 


ports: 
- "3000" 
- "3000-3005" 
- "8000:8000" 
- "9090-9091:8080-8081" 
- "49100:22" 
- "127.0.0.1:8001:8001" 
- "127.0.0.1:5000-5010:5000-5010" 


A 4s 


暴露 端口 ， 只 将 端口 暴露 给 连接 的 服务 ， 而 不 暴露 给 宿主 机 ， 示 例 : 


器 的 端口 (JN 


expose: 


"3000" 
"8000" 


volumes 


卷 挂 载 路 径 设 置 。 可 以 设置 宿主 机 路 径 ( HOST:CONTAINER ) 或 加 上 访问 模式 
( HOST:CONTAINER:ro ) 。 示 例 : 


volumes: 


# 


Just specify a path and let the Engine create a volume 
/var/lib/mysql 


Specify an absolute path mapping 
/opt/data:/var/lib/mysql 


Path on the host, relative to the Compose file 
./cache:/tmp/cache 


User-relative path 
~/configs:/etc/configs/:ro 


Named volume 
datavolume:/var/lib/mysql 


volumes from 


M — ARR e RAE BAERS o TVR RIERA TRE wRGMRARA d8 
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定 ， 则 默认 是 可 读 


— 


o mi ja 


volumes from: 


service name 

service name:ro 

container :container_name 
container :container_name: rw 


environment 


设置 环境 变量 。 可 以 使 用 数组 或 者 字典 两 种 方式 。 只 有 一 个 key 的 环境 变量 可 以 在 
运行 Compose 的 机 器 上 找到 对 应 的 值 ， 这 有 助 于 加 密 的 或 者 特殊 主机 的 值 。 示 例 : 


environment: 
RACK_ENV: development 
SHOW: 'true' 
SESSION SECRET: 


environment: 
- RACK ENV-development 
- SHOW-true 
- SESSION SECRET 


env file 


从 文件 中 获取 环境 变量 ， 可 以 为 单独 的 文件 路 径 或 列表 。 如 果 通 过 docker- 
compose -f FILE 指定 了 模板 文件 ， 则 env file 中 路 径 会 基于 模板 文件 路 
径 。 如 果 有 变量 名 称 与 environment 指令 冲突 ， 则 以 envirment 为 准 。 示 
fal: 


env_file: .env 


env_file: 
- ./common.env 
- ./apps/web.env 
- /opt/secrets.env 


extends 
继承 另 一 个 服务 ， 基 于 已 有 的 服务 进行 扩展 。 
net 


设置 网 络 模式 。 示 例 : 


net: "bridge" 

net: "host" 

net: "none" 

net: "container:[service name or container name/id]" 


dns 


配置 dns 服务 器 。 可 以 是 一 个 值 ， 也 可 以 是 一 个 列表 。 示 例 : 


dns: 8.8.8.8 
dns : 
- 8.8.8.8 
- 9.9.9.9 


dns_search 

配置 DNS 的 搜索 域 ， 可 以 是 一 个 值 ， 也 可 以 是 一 个 列表 ， 示 例 : 
dns_search: example.com 
dns_search: 


- dci.example.com 
- dc2.example.com 


其 他 


docker-compose.yml 还 有 很 多 其 他 命令 ， 本 文 仅 挑选 常用 命令 进行 讲解 ， 其 他 不 
不 作 鞭 述 。 如 果 感 兴趣 的 ， 可 以 参考 docker-compose.yml 文 件 官方 文 


#4 : https://docs.docker.com/compose/compose-file/ 


参考 文档 


Docker Compose 安 装 及 使 用 : http://www.tuicool.com/articles/AnIVJn 


Docker Compose 使 用 全 解 : http://blog.csdn.net/zhiaini06/article/details/45287663 


Docker Compose 命 令 详 
解 : http://blog.csdn.net/wanghailong041/article/details/52162293 


3.8.3 docker-compose.yml % Jf] 4» 4 
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3.8.4 docker-compose 3: M 4» 4 


TODO 
参考 : 
Docker 官 方 文档 : https://docs.docker.com/compose/overview/ 


Dokcer 教 程 : http://wiki.jikexueyuan.com/project/docker-technology-and- 
combat/install.html 


